开源库go-fitz

通俗的语言+实操代码，把 go work 和 go module 的区别、使用场景、实操步骤讲透，新手也能快速理解并上手。

一、先搞懂核心概念​

1. Go Module（Go 模块）​

go module 是 Go 1.11 引入的包管理工具，核心作用是：

• 为单个项目管理依赖（记录依赖版本、解决依赖冲突）；
• 每个项目对应一个 go.mod 文件，标识项目的模块名、Go 版本、依赖列表；
• 本质是「单项目的依赖边界」，确保单个项目的依赖可复现。

2. Go Work（Go 工作区）​

go work 是 Go 1.18 引入的多模块工作区工具，核心作用是：

• 让你在同一个工作目录下，同时开发多个相互依赖的 Go Module 项目；
• 无需频繁 go get/replace 依赖，直接引用本地模块的最新代码；
• 本质是「多模块的开发协作层」，解决多模块本地开发的痛点。

一句话总结核心区别​

二、为什么需要 go work？（解决的痛点）​

假设你有两个本地模块：

• module A：github.com/yourname/project-a（业务项目）；
• module B：github.com/yourname/project-b（A 依赖的工具库）。

没有 go work 时，修改 B 的代码后，要让 A 用上最新的 B，你需要：

1. 在 A 的 go.mod 里加 replace github.com/yourname/project-b => ../project-b；
2. 每次修改 B 后，若路径变化还要改 replace；
3. 提交代码前还要删掉 replace，避免影响生产。

有了 go work 后：

• 只需创建 go.work 文件，声明两个模块的路径；
• A 直接引用本地 B 的最新代码，无需 replace；
• 生产环境不受影响（go.work 不会提交到仓库）。

三、go work 实操步骤（完整示例）​

前置条件​

• Go 版本 ≥ 1.18（执行 go version 检查）；
• 准备两个相互依赖的本地模块（示例结构）：

~/go-projects/  # 工作区根目录
├── project-a/  # 业务模块（依赖 project-b）
│   ├── go.mod
│   └── main.go
└── project-b/  # 工具库模块
    ├── go.mod
    └── utils.go

步骤 1：初始化两个 Go Module​

1.1 初始化 project-b（工具库）​

# 进入 project-b 目录
cd ~/go-projects/project-b
# 初始化模块（模块名自定义，建议用仓库路径）
go mod init github.com/yourname/project-b

创建 utils.go（工具库代码）：

package projectb

// 工具函数：返回字符串
func Hello() string {
    return "Hello from project-b!"
}

1.2 初始化 project-a（业务项目）​

# 进入 project-a 目录
cd ~/go-projects/project-a
# 初始化模块
go mod init github.com/yourname/project-a
# 引入 project-b（此时拉取的是远端版本，后续用 go work 替换为本地）
go get github.com/yourname/project-b

创建 main.go（业务代码）：

package main

import (
    "fmt"
    "github.com/yourname/project-b"
)

func main() {
    // 调用 project-b 的函数
    fmt.Println(projectb.Hello())
}

步骤 2：创建 go work 工作区​

2.1 初始化 go.work​

# 回到工作区根目录
cd ~/go-projects
# 初始化工作区（生成 go.work 文件）
go work init ./project-a ./project-b

执行后，根目录会生成 go.work 文件，内容如下：

go 1.22  # Go 版本

# 引用的本地模块路径
use (
    ./project-a
    ./project-b
)

2.2 验证效果​

# 在工作区根目录执行 project-a 的代码
go run ./project-a
# 输出：Hello from project-b!

# 修改 project-b 的 Hello 函数（比如返回 "Hello from local project-b!"）
# 再次执行，直接生效（无需 go get/replace）
go run ./project-a
# 输出：Hello from local project-b!

步骤 3：go work 核心命令（常用）​

步骤 4：高级用法（replace 临时替换依赖）​

如果需要临时替换某个依赖为本地版本（比如 project-b 依赖的另一个库），可以在 go.work 里加 replace：

go 1.22

use (
    ./project-a
    ./project-b
)

// 临时将 github.com/yourname/project-c 替换为本地路径
replace github.com/yourname/project-c => ./project-c

四、go work 使用注意事项​

1. 不要提交 go.work 到仓库：
   • go.work 是本地开发工具，添加到 .gitignore 即可；
   • 生产环境依赖仍由 go.mod 管理，避免本地路径影响远端构建。
2. 版本兼容：
   • Go 1.18+ 才支持 go work，若团队有低版本 Go，需统一升级；
3. 优先级：
   • 工作区模式下，Go 会优先使用 go.work 里的本地模块，而非 go.mod 里的远端版本；
   • 退出工作区（删除/重命名 go.work），自动恢复为 go module 模式。
4. 多模块构建：
   • 工作区根目录执行 go build ./...，可一次性构建所有模块；
   • 执行 go test ./...，可一次性测试所有模块。

五、核心场景对比（什么时候用什么）​

总结​

1. Go Module 是「单项目依赖管理工具」，核心管依赖版本，生产环境必用；
2. Go Work 是「多模块本地开发工具」，核心解决本地多模块协作，无需频繁改 replace，仅开发用；
3. go work 使用流程：初始化工作区 → 引入多个模块 → 直接开发（本地代码实时生效），无需提交到仓库。