go modules 仅管理 go 代码依赖，不管理 npm、webpack 等前端工具；应将 go 编写的前端辅助工具（如 devserver）置于 cmd/ 下，用 go mod 管理其 go 依赖，并通过 go install 构建后在前端脚本中调用。
Go Modules 不能直接管理前端工具链
Go Modules 是 Go 官方包依赖管理系统，只负责 go build、go test 等 Go 代码构建时的依赖解析与版本锁定。它不感知、也不参与 npm、webpack、vite 或 pnpm 的执行流程——那些是 Node.js 生态的事。试图用 go.mod 声明 typescript 或 esbuild 版本，只会让 go mod tidy 忽略它们，甚至报错“unknown directive”。
真正该用 Go Modules 管理的是「Go 编写的前端辅助工具」
比如你用 Go 写了个本地开发服务器（类似 lite-server），或一个资源哈希生成器、SVG 雪碧图合并器、API Mock 工具——这些可执行程序才是 Go Modules 的管辖范围。
- 把这类工具放在项目根目录下的
cmd/子目录里（如cmd/devserver），每个子目录放一个main.go - 在项目根目录运行
go mod init example.com/frontend-tools，然后go mod tidy自动记录所有 Go 依赖 - 用
go install ./cmd/devserver构建并安装到$GOBIN，后续前端脚本（如package.json中的"dev": "devserver -port 3000"）就能直接调用 - 注意：如果工具依赖了特定 Go 版本特性（如泛型、
io/fs），请在go.mod顶部明确写go 1.18，否则 CI 上可能因 Go 版本低而编译失败
前端项目里混用 Go 工具时，PATH 和构建顺序容易出问题
常见现象是 npm run dev 报错 command not found: devserver，或本地能跑、CI 失败。本质不是 Go Modules 问题，而是环境路径和执行时序没对齐。
- 确保 CI 脚本中先执行
go install ./cmd/...，再运行npm install；否则 npm 生命周期脚本可能早于 Go 工具就绪 - 不要依赖
$GOBIN默认值（如$HOME/go/bin），CI 环境中它可能不在$PATH里；显式加一句export PATH="$HOME/go/bin:$PATH" - 避免在
package.json的prebuild钩子里调用go run cmd/xxx—— 每次都重新编译太慢；应提前go install，钩子里只调二进制 - Windows 下注意换行符和路径分隔符：Go 工具输出的路径别直接喂给 shell 脚本，用
filepath.ToSlash()标准化
go.work 适合多模块前端工具协作，但别滥用
当你的大前端项目里有多个独立 Go 工具（如 cmd/mockapi、cmd/bundlecheck、internal/pkg/assetgen），且它们之间要共享内部包（比如共用一套日志配置或 HTTP 客户端封装），才需要 go.work。
立即学习“前端免费学习笔记（深入）”；
- 在项目根目录运行
go work init，再go work use ./cmd/mockapi ./cmd/bundlecheck ./internal/pkg/assetgen -
go.work文件只影响本地开发时的go命令行为，不会改变go install输出或生成的二进制；生产部署仍靠各模块自己的go.mod - CI 中一般禁用
go.work（设GOFLAGS=-workfile=），避免工作区状态污染；每个工具单独cd进去go install更可靠 - 别把前端源码目录（如
src/、public/）加进go.work—— Go 工具链不处理它们，反而会让go list扫描变慢
真正卡住人的往往不是 Modules 语法，而是混淆了「谁负责什么」：Go Modules 管 Go 代码的依赖快照，Node.js 的 package-lock.json 管前端依赖快照，而两个生态之间的粘合点（比如命令调用、文件输入输出、环境变量传递）必须手动对齐，没有自动魔法。
