go version报“command not found”说明PATH未生效或安装失败；需确认/usr/local/go/bin存在、shell配置文件（如~/.zshrc）正确修改并source，Windows则检查是否勾选“Add Go to PATH”或手动添加C:\Go\bin。
go version 命令报错：command not found
说明系统根本没识别到 go 二进制，不是版本旧或配置错，而是 PATH 没生效或安装失败。
- Linux/macOS 下检查
/usr/local/go/bin是否真实存在：运行ls /usr/local/go/bin，若提示 “No such file”，说明解压失败或路径不对（比如误解压到/opt/go） - 确认 shell 配置文件是否被正确加载：macOS 新默认用
zsh，但你可能改过 shell 或用了bash—— 运行echo $SHELL看输出，再对应修改~/.zshrc或~/.bash_profile - 别漏掉
source步骤：改完配置后必须执行source ~/.zshrc（或对应文件），否则新开终端才生效，当前终端仍无效 - Windows 用户注意：安装时勾选了 “Add Go to PATH” 才会自动写入环境变量；若没勾，需手动在系统环境变量里添加
C:\Go\bin
go mod init 后 go build 报 missing go.sum
这不是错误，是模块初始化后的正常状态 —— go.sum 文件会在首次 go build 或 go mod tidy 时自动生成，记录依赖校验和。
- 直接运行
go mod tidy即可补全依赖并生成go.sum；它会下载缺失包、清理未用包、更新go.mod和go.sum - 如果项目已有
go.mod但go.sum缺失，go build仍能成功（Go 1.16+ 默认开启GOSUMDB=off时允许跳过校验），但上线前务必确保go.sum存在且完整 - CI/CD 流水线中建议显式加
go mod verify步骤，防止依赖被篡改
go run main.go 和 go build 后执行结果不一致
常见于代码里用了相对路径读文件、或依赖未显式声明的本地包 —— go run 在源码目录执行，go build 生成的二进制默认在当前目录运行，但工作目录未必相同。
- 用
os.Executable()+filepath.Dir()获取二进制所在路径，再拼接资源路径，避免硬写"./config.json" - 检查是否误用了
go run .（当前目录下多文件） vsgo run main.go（只编译 main.go）—— 后者会忽略同目录其他.go文件，可能导致逻辑缺失 -
go build -o myapp生成的可执行文件，运行时 cwd 是调用它的位置，不是源码目录；调试时可用pwd和ls -l $(readlink -f ./myapp)确认实际路径
go fmt 和 goimports 冲突导致格式化失败
go fmt 只处理缩进/空格/括号，不管理 import；而 goimports（需单独安装）会增删 import 行 —— 两者混用容易互相覆盖。
立即学习“go语言免费学习笔记（深入）”；
- 推荐统一用
goimports -w .替代go fmt，它兼容go fmt规则且自动整理 import - VS Code 中装
golang.go插件后，默认格式化工具设为gofumpt（更严格）或goimports，别再绑定go fmt - CI 中建议加检查：运行
goimports -l .（不带-w），若有输出说明有未格式化文件，直接 fail
go mod）从 1.16 开始强制启用，但老项目迁移时，GO111MODULE 环境变量若设为 off，会导致 go build 忽略 go.mod、退回到 GOPATH 模式 —— 这种静默降级极难排查。 
