Go覆盖率统计需从首次go test介入，用go test -cover ./递归模块、-covermode=count记录执行次数，生成HTML报告需在go.mod目录执行并终端打开；CI上传需转JSON格式且路径对齐仓库。
Go 的覆盖率统计不是“学完再用”的知识，而是从第一次 go test 就该介入的工程实践——它不依赖额外库，但参数选错、路径跑偏、模式用混，立刻导致数字失真或报告打不开。
怎么跑出靠谱的覆盖率数字（go test -cover）
直接加 -cover 只会输出一行百分比，但它默认只测当前目录下被测试文件 import 的代码，子包、工具函数、main 函数全不算。别被这个数字骗了。
-
go test -cover ./：必须加./才递归整个模块，否则只扫当前包 - 没写测试？报错是
no tests to run，不是 0%，说明根本没触发统计逻辑 - 显示
coverage: 82.1% of statements—— 这只是语句覆盖，if里两个分支都走一遍，也只算“整行覆盖”，不反映分支是否完整 -
init函数永远标红？正常。它在包加载时执行，go test不强制重载，压根没运行
怎么生成能点开的 HTML 报告（go test -coverprofile + go tool cover）
光看百分比没用，得定位哪几行漏了。但生成的 coverage.out 是二进制，且记录的是绝对路径——本地双击打开 HTML 经常跳转失败，不是你操作错了，是路径解析崩了。
- 必须在
go.mod所在目录执行：go test -covermode=count -coverprofile=coverage.out ./ && go tool cover -html=coverage.out -o coverage.html - 别用文件管理器双击
coverage.html，终端里跑open coverage.html（macOS）或start coverage.html（Windows） - 项目用了
vendor？确保没加-mod=vendor以外的干扰参数，否则go tool cover找不到原始源码 - 点文件名跳转失败？先试
go tool cover -func=coverage.out看函数级汇总，更稳
为什么覆盖率数字不准（-covermode 模式选错）
go test -cover 默认用 -covermode=set，只记“有没有执行”，没法区分“只跑一次”和“完全没跑”。想补测试，必须换模式。
立即学习“go语言免费学习笔记（深入）”；
-
-covermode=count：记录每行执行次数，适合定位分支遗漏；单测无并发时首选，快且易读 -
-covermode=atomic：多 goroutine 场景（比如启动 HTTP server 或用time.AfterFunc）必须用它，否则计数可能丢 -
-covermode=func：只告诉你函数调没调过，粒度太粗，基本不用 - 注意：
-covermode=atomic和-race不能共存，会报错cannot use -race and -covermode=atomic together
CI 里上传到 Codecov / Coveralls 总失败（路径和格式问题）
这些平台不认 coverage.out，要 JSON 格式，且路径必须对齐 Git 仓库结构。90% 的失败不是 token 错，是格式或路径不对。
- 先装转换工具：
go install github.com/ory/go-acc@latest - 在 Git 仓库根目录运行：
go-acc -o coverage.json ./ - 确认
git status干净，否则上传路径和远端不一致 - 别用
-coverpkg强拉别人包进报告——那只是把第三方代码的覆盖率算进你的总分，对本包质量零帮助
最容易被忽略的不是灰色行（函数签名、case 标签），而是空 else 块：它在 AST 层不被视为可执行语句，覆盖率工具直接跳过，既不计入分母也不算覆盖——盯它没意义，但得知道它为啥红。
