必须用 go mod init 初始化模块并写 package main 和 func main()；依赖用 go mod tidy 自动管理，go.sum 必须提交；用 go list -m all 验证模块解析正确。
初始化 Go 模块：必须用 go mod init，不能只建空目录
Go 1.11+ 默认启用模块（module）机制，不初始化就写代码，go build 或 go run 会报错：go: cannot find main module。这和以前 GOPATH 时代不同，不是“放对位置就行”，而是必须显式声明模块路径。
在项目根目录执行：
go mod init example.com/myapp
模块名不必真实可访问，但建议用有意义的域名前缀（避免和标准库或常见包冲突）。如果只是本地练习，用 go mod init myapp 也行，但后续引入本地子模块或发布时容易出问题。
- 模块名中不能含大写字母或下划线（Go 包名规范）
- 执行后生成
go.mod文件，记录模块路径和 Go 版本（如go 1.22） - 如果已有
go.mod但路径不对，删掉重来，别手动改——go mod edit易出错
写一个能跑起来的 main.go：入口函数和包声明不能省
Go 不允许无包名文件，也不支持脚本式裸代码。最简可运行结构只有两行：
立即学习“go语言免费学习笔记（深入）”；
package main
func main() {
println("hello")
}
注意：package main 和 func main() 缺一不可。漏掉前者，go build 报 no Go files in current directory；漏掉后者，报 missing main function。
- 文件名任意（不强制叫
main.go），但必须在package main下且含main()函数 - 多个
.go文件可共存于同一目录，只要都属package main - 不要在
main.go里 import 未使用的包，否则编译失败（Go 的强约束）
依赖管理：go mod tidy 是唯一推荐的同步方式
手动编辑 go.mod 极易破坏格式或版本语义。添加新依赖时，直接在代码里写 import "github.com/some/lib"，然后运行：
go mod tidy
它会自动：下载最新兼容版、写入 go.mod、更新 go.sum、清理未使用依赖。
- 不用
go get单独拉包（除非要指定版本，如go get github.com/some/lib@v1.2.0） -
go.sum必须提交到 Git——它是校验依赖完整性的依据，删了会导致go build失败 - 如果公司内网无法访问公网代理，需提前配好
GOPROXY，否则tidy卡住不动
验证环境是否真就绪：用 go list -m all 看模块树
光能 go run main.go 成功，不代表环境干净。比如本地有同名包在 GOPATH 里，可能误用旧版代码。真正确认模块解析正确，运行：
go list -m all
输出第一行应是你自己的模块（如 example.com/myapp），后面跟着所有直接/间接依赖及其版本。如果看到 golang.org/x/... 后面带 // indirect，说明是传递依赖，正常。
- 若输出里混进
./或空白路径，说明go.mod初始化失败或目录嵌套错误 - Windows 用户注意：PowerShell 中
go list可能因路径分隔符报错，换用 CMD 或 Git Bash - CI/CD 流水线里务必加这步检查，避免本地能跑、线上构建失败
go mod init 和 go mod tidy 这两个命令的调用时机与参数组合，比编辑器配置或IDE插件影响更大。很多人卡在“为什么 import 不生效”，本质是模块边界没理清，而不是语法写错了。 
