go mod init 报 no go files 错误是因为当前目录无 .go 文件，需先创建 main.go 再执行 go mod init example.com/myapp；也可直接指定模块名初始化，但不可在 $goroot 等系统目录运行。
go version 能跑通，但 go mod init 报错：no Go files in current directory
说明你当前目录下没有 .go 文件，go mod init 默认会扫描当前目录是否存在 Go 源码来推断模块路径。这不是环境没装好，而是命令执行时机不对。
- 先创建一个空的
main.go（哪怕只写package main），再运行go mod init example.com/myapp - 如果只是想初始化模块而不立即关联代码，可加
-modfile参数或直接指定模块名，Go 不强制要求当前有源文件 - 注意别在 $GOROOT 或系统级目录（如
/usr/local/go）里执行go mod init，会触发权限或路径冲突
VS Code 中 go test 无法识别，提示 command not found: go
这是 PATH 没生效的典型表现——终端里 go version 正常，但 VS Code 启动时没读取 shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile）。
- macOS / Linux：在 VS Code 的设置里搜
terminal.integrated.env，手动把$GOROOT/bin和$GOBIN加进环境变量 - Windows：检查系统环境变量是否包含
%GOROOT%\bin，且 VS Code 是从支持该变量的终端启动（而非桌面快捷方式直启） - 验证方式：在 VS Code 内置终端执行
echo $PATH，确认输出里含 Go 的 bin 路径
go fmt 自动格式化不生效，保存后代码依然混乱
VS Code 的 Go 扩展默认启用 gofmt，但若配置被覆盖或工具链缺失，就会静默失败。
- 检查
settings.json是否显式禁用了"editor.formatOnSave": false或设置了其他 formatter（如gofumpt）但未安装 - 运行
go install golang.org/x/tools/cmd/gofmt@latest确保二进制可用；新版 Go 已内置gofmt，但某些插件仍依赖独立安装 - 若用
gofumpt替代，需额外执行go install mvdan.cc/gofumpt@latest并在设置中指定"go.formatTool": "gofumpt"
air 热重载启动失败，报错 failed to build binary
air 本质是监听文件变化后调用 go build，它不替代 Go 环境本身，任何编译失败都会卡在这里。
- 先手动运行
go build -o app .看是否报错，常见原因是go.mod里依赖版本不兼容或本地 GOPROXY 设置错误 - 检查
.air.toml中的build_cmd是否误写成go run——air要的是可执行文件，不是解释执行 - macOS 上若提示
dyld: Library not loaded，大概率是 Go 升级后旧缓存未清理，删掉$GOPATH/pkg下对应平台目录即可
GO111MODULE 行为在不同 Go 版本间有差异，1.16+ 默认开启，但某些 CI 环境或旧脚本仍硬编码 export GO111MODULE=off，会导致 go mod 命令完全失效——这种问题不会报错，只会默默退回到 GOPATH 模式，直到你发现依赖根本拉不下来。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
