根本原因是系统path未包含go的bin目录，需将/usr/local/go/bin（linux/macos）或c:\go\bin（windows）加入path并source或重启终端验证。
Go 安装后 go version 报错：command not found
根本原因是系统找不到 go 二进制文件，不是没装好，而是 PATH 没配对。
- Linux/macOS：检查
~/.bashrc或~/.zshrc是否添加了export PATH=$PATH:/usr/local/go/bin（macOS Homebrew 安装路径可能是/opt/homebrew/bin） - Windows：确认安装时勾选了 “Add Go to PATH”，若没勾选，需手动把
C:\Program Files\Go\bin加进系统环境变量 - 终端重启后仍无效？试试
source ~/.zshrc（或对应 shell 配置文件），或新开一个终端窗口——别在当前已打开的 tab 里反复go version
用 go mod init 初始化项目却提示 “cannot find module root”
这是 GOPATH 模式残留或当前目录不在模块感知范围内导致的，Go 1.16+ 默认启用模块模式，但不会自动识别任意目录为模块根。
- 确保你在项目根目录下执行：
go mod init example.com/myapp（模块名不一定要真实可访问，但建议符合域名格式） - 如果目录含空格或中文，改用纯英文路径——某些旧版 Go 工具链对非 ASCII 路径解析不稳定
- 已有
go.mod文件但报错？先删掉它再重试；若还报错，检查父目录是否已有更外层的go.mod，Go 会向上查找最近的模块根
go run main.go 提示 “no required module provides package …”
说明 Go 无法解析导入路径，常见于从其他项目复制代码、或没运行过 go mod tidy。
- 先运行
go mod tidy：它会自动补全缺失依赖、清理未使用项，并生成/更新go.sum - 如果依赖包是私有仓库（如 GitHub 私仓），需提前配置 Git 凭据或设置
git config --global url."https://token@github.com".insteadOf "https://github.com" - 遇到
unknown revision错误？大概率是该依赖版本不存在或网络拉不到——换用go get -u或指定确切 commit hash 试试
VS Code 中调试 Go 程序断点不生效
不是代码问题，而是调试器没正确加载符号信息，最常见原因是没装 dlv（Delve）或版本不匹配。
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest安装最新版 Delve（注意：Go 1.21+ 推荐用此方式，而非go get） - VS Code 扩展必须是官方
Go插件（由 Go Team 维护），禁用其他第三方 Go 插件——它们常与调试协议冲突 - 启动调试前确认当前工作区已打开模块根目录（即含
go.mod的文件夹），否则dlv启动时找不到模块上下文
/bin、模块名多一个空格、dlv 版本滞后半步，都会让命令停在半路。真正耗时间的从来不是安装本身，而是验证每一步是否真的被系统“看见”了。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
