# 方法一：官方二进制安装
wget https://go.dev/dl/go1.24.2.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.2.linux-amd64.tar.gz

# 添加到 PATH（写入 ~/.bashrc 或 ~/.zshrc）
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

# 使配置生效
source ~/.bashrc

# 验证安装
go version

# 方法二：使用包管理器（版本可能不是最新）
# Ubuntu/Debian
sudo apt install golang-go

# Fedora
sudo dnf install golang

# Arch Linux
sudo pacman -S go

# 方法一：Homebrew（推荐）
brew install go

# 方法二：官方安装包
# 下载 .pkg 文件：https://go.dev/dl/
# 双击安装即可

# 验证
go version

# 验证（PowerShell）
go version
go env

# 查看所有环境变量
go env

# 查看特定变量
go env GOPATH
go env GOROOT
go env GOPROXY

# 设置环境变量
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GO111MODULE=on

# 推荐使用七牛云代理（中国开发者必配）
go env -w GOPROXY=https://goproxy.cn,direct

# 或使用阿里云代理
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

# 私有仓库配置
go env -w GOPRIVATE=git.example.com,*.corp.example.com

# GOPATH 模式下的工作流
export GOPATH=$HOME/go
mkdir -p $GOPATH/src/github.com/myuser/myproject
cd $GOPATH/src/github.com/myuser/myproject

# 编写代码
cat > main.go << 'EOF'
package main

import "fmt"

func main() {
    fmt.Println("Hello from GOPATH mode!")
}
EOF

# 获取依赖
go get github.com/some/package

# 安装
go install

# 创建项目目录
mkdir myproject && cd myproject

# 初始化模块
go mod init github.com/myuser/myproject

# 生成的 go.mod 文件
cat go.mod

// go.mod
module github.com/myuser/myproject

go 1.24

# 方法一：直接在代码中 import，然后运行
go mod tidy

# 方法二：显式获取
go get github.com/gin-gonic/gin@latest
go get github.com/gin-gonic/gin@v1.9.1
go get github.com/gin-gonic/gin@main  # 指定分支

# 获取指定版本
go get golang.org/x/text@v0.14.0

# 整理依赖（添加缺失的，删除无用的）
go mod tidy

# 下载依赖到本地缓存
go mod download

# 查看依赖图
go mod graph

# 解释为什么需要某个依赖
go mod why github.com/some/package

# 验证依赖
go mod verify

# 编辑 go.mod（一般直接编辑文件）
go mod edit -require github.com/pkg/errors@v0.9.1
go mod edit -replace github.com/old/pkg=github.com/new/pkg@v1.0.0
go mod edit -exclude github.com/bad/pkg@v1.0.0

module github.com/myuser/myproject

go 1.24

require (
    github.com/gin-gonic/gin v1.9.1
    github.com/go-sql-driver/mysql v1.7.1
    golang.org/x/sync v0.6.0
)

// 替换依赖（本地开发调试用）
replace github.com/old/pkg => ../local/pkg

// 排除有问题的版本
exclude github.com/bad/pkg v1.0.0

// retract 撤回已发布的版本
retract v1.0.0 // 发现严重 bug

# 创建工作区
go work init ./moduleA ./moduleB

# 添加模块
go work use ./moduleC

# 生成 go.work 文件
cat go.work

// go.work
go 1.24

use (
    ./moduleA
    ./moduleB
    ./moduleC
)

// 替换（和 go.mod 中的 replace 类似）
replace github.com/dep/pkg => ./local/pkg

# 场景：公司内部 Git 仓库
go env -w GOPRIVATE=gitlab.mycompany.com,github.com/mycompany/*
go env -w GONOSUMCHECK=gitlab.mycompany.com

# 如果需要通过 SSH 访问私有仓库
git config --global url."git@gitlab.mycompany.com:".insteadOf "https://gitlab.mycompany.com/"

// settings.json 推荐配置
{
    "go.useLanguageServer": true,
    "go.lintTool": "golangci-lint",
    "go.lintFlags": ["--fast"],
    "go.formatTool": "goimports",
    "go.testFlags": ["-v", "-count=1"],
    "go.coverOnSave": true,
    "editor.formatOnSave": true,
    "[go]": {
        "editor.codeActionsOnSave": {
            "source.organizeImports": "explicit"
        }
    }
}

# 手动安装常用工具
go install golang.org/x/tools/gopls@latest           # LSP 服务器
go install golang.org/x/tools/cmd/goimports@latest    # 自动管理 import
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest  # 综合 linter
go install github.com/go-delve/delve/cmd/dlv@latest   # 调试器
go install github.com/ramya-rao-a/go-outline@latest    # 大纲视图

" 使用 gopls + nvim-lspconfig
" init.lua 中添加:
require'lspconfig'.gopls.setup{
    settings = {
        gopls = {
            analyses = {
                unusedparams = true,
            },
            staticcheck = true,
            gofumpt = true,
        },
    },
}

package main

import (
    "fmt"
    "os/exec"
    "runtime"
)

func main() {
    fmt.Println("=== Go 环境检查 ===")
    fmt.Printf("Go 版本: %s\n", runtime.Version())
    fmt.Printf("OS/ARCH: %s/%s\n", runtime.GOOS, runtime.GOARCH)
    fmt.Println()

    // 检查工具是否安装
    tools := []string{"gopls", "dlv", "golangci-lint"}
    for _, tool := range tools {
        path, err := exec.LookPath(tool)
        if err != nil {
            fmt.Printf("❌ %s: 未安装\n", tool)
        } else {
            fmt.Printf("✅ %s: %s\n", tool, path)
        }
    }
}

go run main.go