go version不识别需检查PATH和GOROOT是否生效；go mod init须在项目根目录执行；go build需注意CGO_ENABLED和目标平台；VS Code调试应通过扩展自动安装dlv。
go version 命令不识别？检查 PATH 和 GOROOT 是否生效
安装完 .msi 或 .pkg 后，go version 报“不是内部或外部命令”，说明 PATH 没包含 Go 的二进制目录。Windows 上默认应含 %GOROOT%\bin（即 C:\Program Files\Go\bin），macOS/Linux 则依赖 shell 配置文件中是否写了 export PATH=$PATH:/usr/local/go/bin。
验证方式：
- Windows：运行
echo %GOROOT%和echo %PATH%，确认输出里有C:\Program Files\Go\bin - macOS/Linux：运行
echo $GOROOT和echo $PATH；若$GOROOT为空，说明没设或没 source - 别信“安装向导自动配置”——尤其在非管理员账户、多 shell（zsh/bash）混用、或远程桌面环境下，常失效
go mod init 失败提示 “no such file or directory”？先 cd 进项目根目录
go mod init 不是全局命令，它必须在你要初始化的项目文件夹内执行，且该目录下不能已有 go.mod。常见错误是：在桌面或用户主目录直接敲 go mod init myapp，结果生成的 go.mod 被放在了错误位置，后续 go run 找不到依赖或报路径冲突。
正确做法：
立即学习“go语言免费学习笔记（深入）”；
- 新建空目录：
mkdir ~/myproject && cd ~/myproject - 创建入口文件：
touch main.go，写入最简内容：package main; func main() { } - 再执行：
go mod init example.com/myproject（模块名不用真实域名，但别用main或空字符串） - 此时
go.mod会生成在当前目录，且go run main.go才能正常解析模块上下文
go build 生成的二进制文件无法运行？注意 CGO_ENABLED 和目标平台
在 macOS 上用 go build 生成的可执行文件，默认依赖系统 libc 和动态链接器。如果想打包成“开箱即用”的单文件（比如发给没装 Go 的同事），需禁用 CGO 并静态链接：
- Linux/macOS 发布到同平台：
CGO_ENABLED=0 go build -o app . - 交叉编译 Windows 版本（从 macOS 构建）：
GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o app.exe . - Windows 用户若用 MSYS2 或 WSL，务必确认
CGO_ENABLED值——开启时可能因找不到gcc或pkg-config直接失败 -
CGO_ENABLED=0会让 net/http 等包回退到纯 Go 实现，DNS 解析走纯 Go 模式（不调系统 resolver），行为略有差异
VS Code 调试器 dlv 启动失败？别手动 go get，用 VS Code 自动安装
很多教程教你在终端跑 go install github.com/go-delve/delve/cmd/dlv@latest，但新版 VS Code 的 Go 扩展（v0.39+）已改用内置工具管理机制。手动安装容易导致版本错配、二进制权限问题或路径冲突。
推荐流程：
- 确保 VS Code 已安装官方
Go扩展（Publisher: Go Team at Google） - 打开含
main.go的文件夹，按Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入Go: Install/Update Tools - 勾选
dlv，点击确定——扩展会自动下载匹配当前 Go 版本的dlv二进制，并放在$GOPATH/bin或$HOME/go/bin - 重启 VS Code，F5 启动调试；若仍失败，看 VS Code 输出面板里
Go标签页的具体错误，通常是dlv权限不足（macOS Gatekeeper）或路径未加入PATH
go mod init xxx 中的 xxx）一旦写错，后续所有 import 路径、CI 构建、甚至私有仓库拉取都会连锁失败——它不是占位符，而是 Go 包导入系统的唯一标识。 
