如何初始化第一个Golang项目_Golang 项目环境初始化流程_网络技术

必须用 go mod init 初始化模块并写 package main 和 func main()；依赖用 go mod tidy 自动管理，go.sum 必须提交；用 go list -m all 验证模块解析正确。

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 不允许无包名文件，也不支持脚本式裸代码。最简可运行结构只有两行：

package main

func main() {
    println("hello")
}

注意：package main 和 func main() 缺一不可。漏掉前者，go build 报 no Go files in current directory；漏掉后者，报 missing main function。

手动编辑 go.mod 极易破坏格式或版本语义。添加新依赖时，直接在代码里写 import "github.com/some/lib"，然后运行：

go mod tidy

它会自动：下载最新兼容版、写入 go.mod、更新 go.sum、清理未使用依赖。

光能 go run main.go 成功，不代表环境干净。比如本地有同名包在 GOPATH 里，可能误用旧版代码。真正确认模块解析正确，运行：

go list -m all

输出第一行应是你自己的模块（如 example.com/myapp），后面跟着所有直接/间接依赖及其版本。如果看到 golang.org/x/... 后面带 // indirect，说明是传递依赖，正常。

实际项目里，go mod init 和 go mod tidy 这两个命令的调用时机与参数组合，比编辑器配置或IDE插件影响更大。很多人卡在“为什么 import 不生效”，本质是模块边界没理清，而不是语法写错了。