Go generate 中的相对路径为什么取决于源文件目录

Go generate 中的相对路径，基准不是你在终端里输入命令时所在的目录，而是包含 //go:generate 指令的包源目录。因此从仓库根目录执行 go generate ./... 时，Go 仍会逐个进入包目录运行生成器；同一条指令放在不同目录，./schema 指向的文件也会不同。

相对路径的基准是包目录，不是仓库根目录

官方 go 命令文档把这条规则写得很明确：生成器会在包的源代码目录运行。命令行里的 go generate ./... 只是让工具找到多个包并按包处理，不会把所有生成器固定到启动命令的目录。

假设仓库结构如下：

/repo/internal/api/doc.go
/repo/internal/api/schema/user.json
/repo/cmd/schema-gen/main.go

当 doc.go 里写着 -input schema/user.json 时，实际输入是 /repo/internal/api/schema/user.json。即使你在 /repo 下执行命令，也不会变成 /repo/schema/user.json。这也是“根目录运行成功，换个包就找不到文件”最常见的原因。

把输入和输出路径锚定到包含指令的包

包内资源最好和指令放在同一个包目录或其子目录中。下面的指令位于 internal/api/doc.go，所以 schema/user.json 和 user_gen.go 都以 internal/api 为起点：

package api

// 生成器从当前包目录读取 schema，并把结果写回当前包。
//go:generate go run example.com/demo/cmd/schema-gen -input schema/user.json -output user_gen.go

生成器内部也不要假定进程启动位置，直接把相对参数和 os.Getwd 得到的目录组合：

package main

import (
    "log"
    "os"
    "path/filepath"
)

func main() {
    // go generate 会把这里的工作目录设为指令所在包目录。
    workDir, err := os.Getwd()
    if err != nil {
        log.Fatal(err)
    }
    input := filepath.Join(workDir, "schema", "user.json") // 输入相对包目录稳定
    output := filepath.Join(workDir, "user_gen.go")         // 输出也回到当前包
    if err := generate(input, output); err != nil {
        log.Fatal(err) // 让 go generate 感知失败，停止继续处理该包
    }
}

仓库级工具要减少对 ../ 层数的依赖

如果生成器位于仓库的 cmd/schema-gen，在固定层级的包里使用 ../../cmd/schema-gen 可以工作，但包一旦移动，指令就会失效。更稳的做法是使用模块路径调用，例如上面的 example.com/demo/cmd/schema-gen，让 Go 按当前模块解析工具包。

共享模板或仓库根配置也不要把“启动命令目录”当成根目录。生成器可以从当前目录向上寻找 go.mod，或者执行 go env GOMOD 获取当前模块文件，再用 filepath.Dir 得到模块根。若项目处在 GOPATH 模式、没有可用的 go.mod，则应通过指令显式传入配置目录，避免把空路径误当成根目录。

还有一个容易误用的变量：$GOFILE 只提供指令所在文件的基本名称，不能直接当目录使用。要得到目录，仍应以生成器的工作目录为基准，或由调用方传入完整路径。

用目录矩阵检查命令入口和生成目录

排查时先看三件事：指令到底在哪个包；资源是否真的相对该包存在；生成器是否把当前工作目录、模块根和输出目录混成了一个概念。把这三层分开后，换成 go generate ./internal/api、go generate ./... 或 CI 的绝对工作区，路径行为都能预测。

常见问题

从仓库根目录执行 go generate，为什么仍然找不到 ./cmd 工具？

因为 ./cmd 是相对生成器工作目录解析的。如果指令位于 internal/api，它会寻找 internal/api/cmd；改用模块导入路径，或传入正确的相对路径。

把指令放进子目录后，schema 文件为什么突然失效？

指令随包目录改变，schema/x.json 的锚点也改变。将资源移动到该包下，或者由指令显式传递模块根和资源绝对路径。

能不能用 $GOFILE 反推出源文件目录？

不能。它只有基本文件名；目录应来自生成器的工作目录，或由调用方以参数形式提供。