go version通过≠环境就绪：必须验证go env GOROOT/GOPATH、确保PATH包含$GOROOT/bin和$GOPATH/bin，且source配置文件；统计行数用os.ReadFile+bytes.Count更稳，复杂度分析用gocyclo@latest并配合git diff增量扫描。
Go 环境装好就能跑 go run，但要真正做工程化统计（行数、复杂度），光靠 go version 验证是远远不够的——必须配好工具链、理解各工具边界、避开默认行为坑点。
go version 能过 ≠ 环境 ready
很多新手卡在第一步：明明 go version 有输出，go mod init 却报错找不到命令。这不是 Go 没装好，而是 PATH 没生效或 shell 配置没重载。
- Windows 用户用
.msi安装器一般没问题；Linux/macOS 手动解压后，必须确认/usr/local/go/bin（或你自定义的GOROOT下的bin）已加入PATH，且当前终端已执行source ~/.zshrc（或~/.bashrc） -
GOROOT多数情况不用手动设——现代 Go 安装器会自动推导；但若曾手动改过，又删了旧版本，go命令可能指向已不存在的路径，直接报command not found - 验证方式不是只看
go version，还要跑：go env GOROOT和go env GOPATH，确保两者都指向真实存在的目录
统计代码行数：别用 strings.Split + bufio.Scanner 组合
写个脚本统计 .go 文件行数时，常见组合是 bufio.Scanner 读行 + strings.Split 切换行符，但这两种方式叠加会放大风险：超长行触发 scanner: too long，而 strings.Split 又大量分配小字符串，GC 压力陡增。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 单文件统计优先用
os.ReadFile+bytes.Count(b, []byte("\n"))：快、稳、内存可控 - 遍历目录必须用
filepath.WalkDir，不是filepath.Walk：前者不自动进入 symlink，也不跳过权限错误，得显式返回filepath.SkipDir处理/proc或/sys类目录 - 后缀过滤别写
strings.HasSuffix(path, ".go")，要用strings.HasSuffix(entry.Name(), ".go")——entry.Name()是纯文件名，path是全路径，混用会导致vendor/xxx.go被漏掉 - 空行和注释行判断前，先用
bytes.TrimPrefix清 BOM：bytes.TrimPrefix(b, []byte("\xef\xbb\xbf"))，否则 UTF-8 编码的.go文件第一行永远算作非空
复杂度分析：gocyclo 不是覆盖率，别和 go test -cover 混用
gocyclo 输出的数字是函数级控制流分支计数（if/for/switch/case/goto 各 +1），它不关心是否被测试覆盖，也不依赖 AST 全局解析——所以它快、轻量、适合 CI 卡点，但也因此容易“虚高”。
立即学习“go语言免费学习笔记（深入）”；
- 安装命令是
go install github.com/fzipp/gocyclo/cmd/gocyclo@latest，注意带@latest，否则可能拉到旧版（2026 年最新版已支持 Go 1.26） - CI 中只扫变更文件：
git diff --name-only HEAD~1 | grep '\.go$' | xargs gocyclo -over 8，避免老代码拖累新 PR - 大型
switch或连续if err != nil会让分值飙升，但这是 Go 推荐写法——遇到这类情况，加//gocyclo:ignore注释比硬拆函数更合理 -
gocyclo对语法错误会 panic，建议在 CI 脚本里加|| true，再用日志判断是否真有超限函数，而不是让构建直接失败
真正麻烦的从来不是装几个命令，而是搞清每个工具的职责边界：Go 自带的 go 命令管构建和模块，gocyclo 管函数结构健康度，scc 或 gocloc 管项目规模快照——它们互不替代，也互不兼容输出格式。选哪个、怎么串、在哪卡阈值，得根据团队对“可维护性”的实际定义来定，不是堆工具就行。
