go test -cover 仅输出模糊百分比或“no test files”，因未运行测试：常见原因是_test.go命名错误、Test函数命名/签名不规范、未在含测试文件的包路径下执行；需用go test -covermode=count -coverprofile=coverage.out生成可分析文件，再通过go tool cover定位未覆盖行。
直接跑 go test -cover 只能看一个模糊的百分比，没法定位哪行没测、哪个分支漏了——真要查覆盖率，必须生成 coverage.out 文件再用 go tool cover 解析。
go test -cover 为什么只输出 0.0% 或 no test files
这不是覆盖率低，是测试根本没跑起来。常见原因有三个：
-
*_test.go文件名写错，比如叫test_utils.go或utils_test.bak，Go 会直接忽略 - 测试函数没按规范命名：必须是
func TestXxx(t *testing.T)，首字母大写，参数类型严格匹配 - 没在含测试文件的包路径下执行，比如
go test在项目根目录跑，但*_test.go其实放在./pkg/http里，得先进入该目录或显式写go test ./pkg/http
快速验证方法：加 -v 参数，看终端是否打印出 === RUN TestXXX —— 没这行，说明测试压根没触发。
怎么生成能定位问题的 coverage.out
关键不是“有没有 -cover”，而是必须带 -coverprofile，且推荐搭配 -covermode=count：
立即学习“go语言免费学习笔记（深入）”；
-
go test -covermode=count -coverprofile=coverage.out ./：覆盖当前模块所有子包，记录每行执行次数（不是只记“有/无”） - 末尾用
./（不是./...或省略），否则只测当前目录，子包数据不会写入coverage.out - Windows 下注意大小写：
Coverage.out≠coverage.out；Linux/macOS 同理，文件名必须完全一致 - 如果测试中途 panic 或 timeout，
coverage.out可能为空，重跑前先用go test -v确认测试函数确实执行了
go tool cover -html 打开后全是灰色或打不开文件
灰色代码基本可忽略——它代表不可测区域（空行、注释、函数签名、default 分支等），真正要盯的是红色（未覆盖）和绿色（已覆盖）。打不开源码文件，通常是路径映射失败：
-
coverage.out里存的是绝对路径；如果在容器或 CI 中生成，本地打开 HTML 时浏览器找不到对应文件 - 解决办法：确保在
go.mod所在目录执行全部命令；或者改用go tool cover -func=coverage.out查函数级汇总，不依赖路径 -
go tool cover -html=coverage.out -o coverage.html必须和coverage.out在同一目录运行，否则报open xxx.go: no such file or directory - 点文件名跳转失败？别双击 HTML 文件，用
python3 -m http.server 8000起个本地服务再访问http://localhost:8000/coverage.html
为什么 init 函数、空 else 块、main 函数总显示未覆盖
这不是 bug，是 Go 覆盖率工具的设计限制：
-
init()函数不会被插桩统计，哪怕它被调用了——因为它是包加载时自动执行的，不属于测试可控制路径 - 空
else块、空default分支、纯return行，Go 认为“不可覆盖”，直接标灰，不参与分母计算 -
func main() { ... }不会被统计，除非你手动调用它（不推荐）；命令行入口逻辑建议拆到可导出函数中再测 - 用
//go:noinline标记的函数，如果被内联了，也会整块变灰；想调试覆盖情况，可临时加该标记强制保留函数体
最常被忽略的一点：-coverpkg 不是默认开启的——如果你的测试在 cmd/ 下，但业务逻辑在 pkg/，不加 -coverpkg=./...，pkg/ 里的代码根本不会被插桩，自然不出现在报告里。
