go version能运行但go mod tidy卡住，是因为前者仅检查本地二进制，后者需联网下载依赖；必须配置GOPROXY为国内镜像（如https://goproxy.cn）、GO111MODULE=on，并将私有仓库域名加入GOPRIVATE，且确保环境变量在shell和IDE中均生效。

为什么 go version 能跑通，但 go mod tidy 却卡住

这不是环境没装好，而是网络代理和模块代理没配对。go version 只检查本地二进制，不走网络；go mod tidy 却要连 proxy.golang.org 或你配置的 GOPROXY 下载依赖，国内直连基本超时。

• GOPROXY 必须显式设为国内镜像，比如 https://goproxy.cn 或 https://mirrors.aliyun.com/goproxy/，不能只靠 go env -w 临时设置，得写进 shell 配置文件（~/.zshrc 或 ~/.bashrc）并 source
• GO111MODULE=on 要开启，否则老项目可能 fallback 到 GOPATH 模式，触发路径误判
• 私有仓库（如公司内网 Git）必须加到 GOPRIVATE，否则 go 会试图通过代理解析，导致 403 或 timeout —— 常见值如 GOPRIVATE=git.internal.company.com
• 验证是否生效：运行 go env GOPROXY 和 go env GOPRIVATE，输出应与你写的完全一致，不含空格或引号

Linux 下用包管理器装 Go 真的省心吗

不一定。apt/yum 安装的 golang-go 或 golang 包，版本往往滞后 2–3 个 minor 版本（比如系统源里还是 go1.21，而官网已是 go1.23），且无法共存多版本。适合快速试用，不适合生产级开发。

• Ubuntu/Debian 的 golang-go 通常装在 /usr/bin/go，但 GOROOT 未设，go env GOROOT 可能为空，某些工具（如 dlv）会报错找不到 SDK
• 想用最新版或多个版本，必须手动下载官方 .tar.gz 并解压到 /usr/local/go，再配 GOROOT —— 这步绕不开
• 若已用包管理器装过，先 sudo apt remove golang-go（Ubuntu）或 sudo yum remove golang（CentOS），再手动安装，避免 PATH 冲突

VS Code 里 go tools 安装失败，提示 “failed to install”

根本原因不是插件问题，而是当前 shell 环境变量没被 VS Code 继承，尤其是 GOPROXY 和 PATH。VS Code 启动方式很重要：必须从终端用 code . 打开，而不是桌面图标双击。

Golang Google Wire

在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface

下载

• 双击图标启动的 VS Code 不读取 ~/.zshrc，go 命令可能找不到，GOPROXY 为空，导致 go install 失败
• 首次打开 .go 文件时弹出的 “Install All” 按钮，背后执行的是 go install 命令，它依赖当前 shell 的全部环境变量
• 解决方法：关掉 VS Code，终端运行 code .，再打开项目；或在 VS Code 设置里加 "go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn" }
• 个别工具（如 gopls）需额外指定版本：运行 go install golang.org/x/tools/gopls@latest 手动装，比插件自动装更稳

多版本 Go 共存时，怎么确保项目用对版本

靠 go env GOROOT 和 PATH 顺序不够可靠，尤其当你频繁切换项目时。真正可控的方式是项目级声明 + 工具链介入。

立即学习“go语言免费学习笔记（深入）”；

• 在项目根目录放一个 go.version 文件（纯文本，内容如 1.22.4），这是社区事实标准，gvm、asdf、direnv 都认
• 用 asdf 管理多版本：先 asdf plugin-add golang，再 asdf install golang 1.22.4，然后 asdf local golang 1.22.4 —— 该命令会在当前目录生成 .tool-versions 文件，自动切换
• 不要依赖 go version 输出判断，而要看 which go 和 go env GOROOT，二者必须指向同一路径，否则说明 PATH 混乱
• CI/CD 中必须显式指定 Go 版本（如 GitHub Actions 的 actions/setup-go@v5），本地环境再准，CI 用错版本照样构建失败

实际搭环境时，最易被忽略的是 shell 配置文件的加载时机和 VS Code 的启动方式——这两点不出问题，90% 的“环境异常”都能提前规避。