Go模块发布时临时文件不会被自动排除，因go工具链不识别“临时性”，仅按包结构和构建约束处理文件；误提交会导致体积增大、路径泄露、校验失败或构建错误，须靠.gitignore和t.Cleanup等手段主动防护。
发布 Go 模块时，临时文件（如 os.CreateTemp 生成的文件、测试中未清理的 tmp/ 目录、编辑器缓存等）不会被自动排除，一旦误提交进 Git，就会随 go mod publish 或源码分发进入模块快照——这不仅增大体积，还可能泄露敏感路径、触发校验失败或让下游构建出错。
为什么 go build 和 go list 不会帮你过滤临时文件
Go 工具链只按包结构和构建约束识别源码，它不扫描“临时性”。只要一个 .go 文件在包目录下、满足命名和 tag 规则，就会参与编译；同理，go mod publish 打包的是整个 Git commit 的文件树，和你本地 /tmp 无关，但和你 git add 进去的 ./tmp/ 或 ./data-*.log 强相关。
-
go build -tags=ignore只跳过带// +build ignore的源文件，对.tmp、.out、coverage.out等二进制或数据文件完全无效 -
go list -f '{{.GoFiles}}'输出的是 Go 源文件列表，不反映你是否意外git add了upload-abc123.tmp - CI 构建失败报
checksum mismatch，往往是因为go.sum里记录了某次本地测试生成的临时文件路径（比如用os.CreateTemp("", "*.json")写入后又git add了），而其他环境无法复现该路径
哪些文件必须写进 .gitignore 才算真正安全
不是“可能临时”，而是“明确非源码、非配置、非依赖声明”的三类文件，必须无条件忽略：
-
bin/、dist/、out/：构建产物目录，Go 默认不建，但 CI 脚本或 Makefile 常用 -
*.exe、*.out、*.test、coverage.out：可执行体与覆盖率输出，Windows/Linux/macOS 下都存在 -
pkg/、vendor/（若未启用 vendor）、.vscode/、.idea/、.DS_Store：模块缓存、IDE 元数据、系统隐藏文件
注意：go.mod 和 go.sum 必须提交，它们是模块身份的核心凭证；vendor/ 只有在显式运行 go mod vendor 后才应提交，否则加进 .gitignore。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
测试中生成的临时文件怎么避免污染 Git
测试代码里调用 os.CreateTemp 或 os.MkdirTemp 是合法的，但必须确保：文件没被 git add，且测试退出后立即销毁。
- 永远不要在测试中写类似
os.CreateTemp("./tmp", "*.log")——./tmp是相对路径，容易被误git add -A进去；改用os.CreateTemp("", "test-*.log")，让系统选/tmp或%TEMP% - 测试函数内立刻注册
t.Cleanup(func() { os.Remove(tmpFile.Name()) })，而不是靠defer；t.Cleanup在 panic、失败、成功时都触发，defer在测试 goroutine 中不可靠 - 多个临时文件统一放一个
os.MkdirTemp目录下，然后t.Cleanup(func() { os.RemoveAll(dir) })—— 删目录比删几十个文件更可控，也避免漏删
发布前最后一道防线：检查 Git 状态和打包内容
别信“我肯定没加”，每次 git push 前手动验证：
- 运行
git status --ignored，确认所有临时文件都在 ignored 列表里；如果看到untracked files里有*.tmp或tmp/，立刻git clean -fdX（X表示只清忽略项） - 用
git archive HEAD | tar -t | grep -E '\.(tmp|out|exe|test)$'模拟发布打包过程，看是否有不该出现的后缀 - CI 流水线里加一步：
git ls-files | grep -E '^(bin|dist|pkg|\.vscode|\.idea)/'，命中即 fail —— 防止本地疏忽
最易被忽略的是：你在本地跑测试生成了 report-20260805-*.csv，顺手 git add . 时没注意，这个文件就进了 commit；而 Go 模块发布时，它就成了公开 API 的一部分——哪怕你从没导出过这个文件名，下游 go get 下来也会拿到它。
