根本原因是path未正确配置；macos/linux需确认shell类型并修改对应配置文件（如~/.zshrc）添加export path=$path:/usr/local/go/bin，windows需在系统环境变量path中添加go的bin路径并重启终端。
Go 安装后 go version 报错：command not found
根本原因几乎都是 PATH 没配对。macOS/Linux 下常见于用了 zsh 但把 export PATH 写进了 ~/.bash_profile；Windows 则常因安装时没勾选「Add to PATH」，或手动添加后没重启终端。
实操建议：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- macOS/Linux：检查当前 shell 类型（
echo $SHELL），对应修改~/.zshrc或~/.bashrc，追加export PATH=$PATH:/usr/local/go/bin（路径以你实际安装位置为准） - Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，在「系统变量」中找到
Path，新增一行C:\Program Files\Go\bin（注意不是 Go 安装目录，是其下的bin子目录） - 改完别忘了重开终端，再执行
go version验证
用 go mod init 初始化模块却提示 go: go.mod file already exists
这不是错误，是提醒你当前目录或其父目录已存在 go.mod。Go 的模块查找会向上遍历直到根目录或遇到 go.work，所以很容易“误入”已有模块范围。
实操建议：
- 先运行
go env GOPATH和go env GOMOD，确认当前是否在某个模块内 - 想新建独立模块？退到空目录下操作，或用
go mod init example.com/myapp强制初始化（即使有旧go.mod，只要不在当前目录就 OK） - 若真要覆盖，先
rm go.mod go.sum，再go mod init；但务必确认没误删他人项目文件
go run main.go 编译失败，报错 cannot find package
多数情况是依赖没下载，尤其当项目启用了 Go Modules（即有 go.mod）但还没拉取第三方包。Go 不再默认从 $GOPATH/src 查找，而是严格按 go.mod 声明的版本去 $GOPATH/pkg/mod 或 proxy 下载。
实操建议：
- 先执行
go mod tidy，它会自动补全缺失依赖、清理未使用项，并写入go.mod和go.sum - 国内用户大概率遇到 proxy 超时，临时切镜像：
go env -w GOPROXY=https://goproxy.cn,direct - 如果某包仍找不到，检查
go.mod里 require 的路径是否拼写正确（比如github.com/gin-gonic/gin少了个-就会失败）
VS Code 里调试不进断点，或提示 Failed to launch: could not launch process
本质是调试器（Delve）和 Go 工具链不匹配。常见于升级 Go 后没同步更新 dlv，或 VS Code 的 Go 扩展版本太老。
实操建议：
- 先运行
go install github.com/go-delve/delve/cmd/dlv@latest更新调试器（新版 Go 推荐用go install而非go get） - VS Code 中打开命令面板（Cmd+Shift+P），搜 “Go: Install/Update Tools”，全选并安装，确保
dlv在列表中且状态为 ✔ - 检查
.vscode/settings.json是否误设了"go.gopath"—— Go 1.16+ 默认关闭 GOPATH 模式，设了反而干扰模块识别
go get 在 1.16 前后语义完全不同，go.work 又在 1.18 引入多模块协作机制。搭一次环境容易，但后续每次升级 Go 或换机器，都得重新核对这些隐性约定。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
