必须确保模块初始化、编译路径和环境变量三者对齐才能成功生成可执行文件；go mod init 需在根目录执行，推荐写法为 example.com/myapp；go build 三种方式输出名不同；go install . 生成的二进制需 $GOPATH/bin 在 PATH 中才可全局调用；IDE 缓存可能导致环境变量更改后功能异常。
直接装完就能 go run，但想生成可执行文件（比如 myapp.exe 或 myapp），必须确认模块初始化、编译路径和环境变量三者对齐；否则会报 build failed: no Go files in current directory 或生成的二进制无法运行。
go mod init 必须在项目根目录执行
模块路径不是物理路径，也不是随便起名——它决定了 go build 能否识别入口包、依赖能否正确解析。
- 错误做法：
go mod init /home/user/myproj（含绝对路径）或go mod init My_Project（含大写/下划线） - 推荐写法：
go mod init example.com/myapp（域名反写+小写字母+短横线） - 只要
main.go在当前目录且package main正确，go build就能定位到入口 - 如果项目里有多个
.go文件但没main函数，go build会静默失败，不报错也不生成文件
go build 的三种常用方式及输出差异
go build 默认行为取决于当前目录是否有 main 包和 go.mod，不同调用方式产出的可执行文件名和位置完全不同。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
go build main.go：只编译这个文件，输出名固定为main（Windows 是main.exe），不读go.mod里的模块名 -
go build（空参数）：按go.mod第一行的模块名生成可执行文件，例如go mod init example.com/myapp→ 输出myapp -
go build -o mytool：强制指定输出名，跨平台一致（Linux/macOS 无后缀，Windows 自动加.exe） - 注意：
go build不会把结果放进$GOPATH/bin，那是go install干的事
GOPATH/bin 和 PATH 配合才能全局调用
很多人以为 go install . 后就能直接敲命令运行，结果提示 command not found——问题不在编译，而在系统找不到那个二进制。
立即学习“go语言免费学习笔记（深入）”；
-
go install .会把可执行文件放进$GOPATH/bin（默认是$HOME/go/bin） - 但该目录必须已加入
PATH，否则终端不认识你刚安装的命令 - 验证方法：
echo $PATH | grep go（macOS/Linux）或echo %PATH%（Windows），确认含/home/xxx/go/bin或C:\Users\xxx\go\bin - 常见坑：改了
GOPATH却忘了同步更新PATH；或者用了go build -o但没手动挪到$GOPATH/bin下
真正容易被忽略的是 IDE 缓存：VS Code 的 Go 插件会记住首次启动时读到的 GOPATH 和 GOROOT，改完环境变量不重启编辑器，go install 成功了也看不到命令补全、跳转失效。不是配置错了，是它根本没重新加载。
