go version无响应或报错说明path未配置，需检查windows的add go to path选项或macos/linux的shell配置文件；模块代理被墙时设goproxy=https://goproxy.cn,direct；import路径不匹配需修正module声明或用replace；vs code缺工具需手动运行go: install/update tools。
go version 命令没反应或报“command not found”
说明 go 二进制文件没进系统 PATH，不是 Go 没装好，而是 Shell 找不到它。
- Windows：检查安装时是否勾选了 Add Go to PATH；若没勾，手动在“系统环境变量”中把
C:\Go\bin（或你自定义的%GOROOT%\bin）加到PATH - macOS/Linux：确认
~/.zshrc或~/.bashrc里有这行：export PATH=$PATH:/usr/local/go/bin（或你解压的实际路径），然后运行source ~/.zshrc - VS Code 终端可能不读 shell 配置：重启 VS Code，或在终端里先执行
source ~/.zshrc再试
go get 或 go mod download 卡住、超时、报 proxy.golang.org 连接失败
这是国内最常见问题，本质是模块代理不可达，不是网络断了，而是默认代理被墙。
- 别改 hosts 或开全局代理——Go 的
GOPROXY是独立控制的，直接设环境变量最稳 - 执行这两条命令即可生效（永久写入）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 如果公司内网有私有代理，替换为内部地址，例如
https://proxy.internal.company.com
go mod init 后 go build 报 cannot find package “xxx”
不是包没下载，而是模块路径和 import 路径不一致，尤其容易发生在从 $GOPATH/src 迁移旧项目时。
- 检查
go.mod第一行：module example.com/myproject—— 这个路径必须和代码里所有import的前缀完全匹配 - 比如
import "github.com/sirupsen/logrus"没问题，但import "myproject/utils"就要求myproject/utils在当前模块路径下可解析 - 临时解决：用
replace重定向本地路径，例如：replace myproject/utils => ./internal/utils - 根本解法：统一用相对路径导入，或把项目根目录设为模块根，避免嵌套
src/目录
VS Code 中 Go 扩展提示“Missing tools”或无法跳转定义
VS Code 的 Go 插件（golang.go）依赖一组 CLI 工具，如 gopls、dlv、goimports，它们不会随 Go 安装自动装上。
- 不要点插件弹窗里的 “Install All” —— 它常因网络问题卡死或装错版本
- 手动触发安装：打开命令面板（
Ctrl+Shift+P），输入Go: Install/Update Tools，勾选全部，回车 - 确保
GOPROXY已设好（见上一条），否则gopls下载会失败 - 装完后重启 VS Code，再看状态栏右下角是否显示
gopls (running)
GOPROXY 和 GO111MODULE=on 这两个开关，漏掉任何一个，后续所有操作都会无声地变慢或失败。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
