Go学习笔记：基本概念与项目结构——GOPATH、Go Modules 与常用命令

📝本文首发于 栏轩·阁

欢迎访问阅读原文，获取更好的阅读体验。

一、Go 的项目结构

Go 的项目结构经历了两代：GOPATH 模式（旧）和Go Modules 模式（新，现在用的）。

1.1 GOPATH 模式（了解即可）

早期 Go 的所有项目都必须放在$GOPATH/src下。GOPATH默认是$HOME/go（Linux/Mac）或C:\Users\用户名\go（Windows）。

$GOPATH/ ├── src/ ← 源代码放在这里 ├── pkg/ ← 编译后的包 └── bin/ ← 编译后的可执行文件

查看当前的 GOPATH：

goenvGOPATH

1.2 Go Modules 模式（现代方式）

从 Go 1.11 开始引入，Go 1.16 起默认开启。你不再需要把项目放在 GOPATH 下，任何目录都可以是一个 Go 项目。

每个 Go 项目就是一个模块（Module），模块根目录下必须有go.mod文件。

二、依赖管理：go.mod 和 go.sum

2.1 go.mod — 模块定义文件

类似于 Node.js 的package.json，但更简洁。用go mod init创建：

go mod init 项目名

生成的go.mod示例：

module gotest ← 模块名 go 1.24 ← Go 版本 require ( ← 依赖的第三方包 github.com/xxx v1.2.3 )

2.2 go.sum — 依赖锁文件

类似于package-lock.json或yarn.lock。不要手动编辑，由 Go 自动维护。

作用：

• 记录每个依赖包的哈希值
• 确保每次下载的依赖内容一致
• 防止依赖被篡改

2.3 常用依赖命令

# 添加依赖（在代码中 import 后，go mod tidy 会自动下载）go mod tidy# 整理依赖：添加需要的，移除没用的# 查看依赖go list-mall# 列出所有依赖# 下载依赖到本地缓存go mod download# 将依赖复制到 vendor 目录（可选，类似于 node_modules）go mod vendor

三、GoLand 创建项目的三种模式

创建项目时会看到三个选项：

现在一律选第一个「Go」模式，它自动启用 Go Modules。

四、最简单的代码结构

一个最小的 Go 项目：

myapp/ ├── go.mod ← go mod init 生成 └── main.go ← 入口文件

// main.go — 最简单的 Go 程序packagemain// 可执行程序必须用 package mainimport"fmt"// 标准库：格式化输入输出funcmain(){// 程序入口fmt.Println("Hello, Go!")}

五、常用运行命令

# 直接运行（编译 + 运行，不生成文件）go run main.go# 编译为可执行文件go build# 生成 .exe（Windows）或 可执行文件（Linux/Mac）# 编译并安装到 GOBIN 目录goinstall# 格式化代码（Go 官方标准）gofmt-l.# 检查格式gofmt-w.# 自动修正格式# 静态检查go vet ./...# 检查代码中可能的 bug# 查看环境信息goenv# 打印所有环境变量go version# 查看 Go 版本

run vs build 区别

六、小结