go build无法直接跳过文件，必须用构建约束或文件名后缀实现编译期排除；//go:build !linux需置于文件首行且与package间有空行，后缀与标签是“与”关系，任一不满足即跳过。

go build 怎么跳过某个平台专属文件

Go 不支持用命令行参数直接排除单个 .go 文件，必须靠构建约束（build tags）或文件名后缀让编译器“看不见它”。平台专属文件（比如 server_linux.go）若想在非 Linux 环境下彻底不参与构建，不能只靠文件名，得加显式约束。

• //go:build !linux 要写在文件最开头，且与 package 之间**必须有空行**；用 /* */ 块注释无效
• 文件名后缀（如 _darwin.go）和构建约束是“与”关系：两者都满足才参与编译；任一不满足就跳过
• 不要混用旧式 // +build 和新式 //go:build——Go 1.17+ 推荐只用后者，双写更稳妥：//go:build ignore + // +build ignore
• 验证是否生效：运行 go list -f '{{.GoFiles}}' ./，输出里不该出现该文件名

为什么 server_linux.go 在 macOS 上仍被编译

常见原因是构建约束写错或没生效。文件名后缀只起“默认过滤”作用，但一旦文件里写了 //go:build darwin,ignore 这类标签，而你又没传 -tags=ignore，它反而可能被意外包含——因为 darwin 标签不匹配，但 ignore 标签若未显式启用，整个约束表达式就失效了。

• 平台后缀（_linux.go）本身不是“开关”，只是辅助标识；真正起效的是构建约束逻辑
• go build 默认不启用任何 tag，所以 //go:build linux 的文件在 macOS 上自然被跳过，但 //go:build !linux 的文件在 macOS 上反而会被选中——这常被误认为“反向排除成功”，其实是逻辑翻车
• 想确保某文件绝对不参与任何构建，唯一可靠方式是 //go:build ignore（Go 1.17+）并配合 go build -tags=ignore；不传 -tags 参数时，它不会被加载

go:generate 文件误编译导致 undefined 错误

很多项目把代码生成逻辑写在 gen.go 里，顶部只加了 //go:generate，却忘了加构建约束。结果 go build 尝试编译它，而它依赖尚未生成的类型或未安装的工具，直接报 undefined: XXX 或 cannot find package。

ClawUsage Windows Hardlock

通过聊天（Telegram / 飞书）执行本地 `clawusage` 监控命令。当用户输入 `/clawusage ...`，或提出“查看 Codex 用量”、“开启/关闭自动…”等请求时触发使用。

下载

• 正确做法：在 gen.go 第一行写 //go:build ignore，紧接着空一行，再写 package main
• 别把 gen.go 放进主包目录还指望靠名字躲过编译——_test.go 是特例，gen.go 没这种豁免权
• CI 中避免用 -tags=all，它会强制启用所有标签，包括 ignore，导致本该跳过的文件被编译

跨平台构建时 vendor 目录里的文件怎么处理

go mod vendor 只是把依赖复制进 vendor/，但 go build 默认仍走 module mode，不会自动识别 vendor 里的构建约束。如果你依赖的某个模块内部有 xxx_windows.go，而你在 Linux 构建，它本该被跳过——但前提是 vendor 里的源码没被污染或手动改过。

• 确保 go mod vendor 后不手动修改 vendor/ 下任何文件，否则构建约束可能被破坏
• 离线构建必须加 -mod=vendor 参数，否则 go build 会忽略 vendor/ 并去查 $GOPATH/pkg/mod
• vendor 目录下文件的构建约束行为，和主项目完全一致——它不享有特殊豁免，该跳过还是跳过，该报错照样报错

真正容易被忽略的是：构建约束不是“注释”，而是编译器解析的指令；空行、换行符、大小写、标签拼写，错一个字符就失效。别依赖“看起来像对了”，要用 go list 验证。