跳到主要内容

Go 常见问题笔记

本篇按 「问题 / 现象 / 解决 / 原理」 四段模板收集 Go 实战中踩过的坑。后续遇到同类问题直接 append 到这里。 原稿 旧稿 整理后作为 Q1。


Q1. go build / go run 突然变慢​

问题​

某次 go build / go run 编译时间突然从几秒变成几十秒,CPU 不忙但磁盘狂转。

现象​

  • 编译时间和项目规模不匹配
  • 单文件 demo 也要几秒
  • Windows 上更明显
  • 任务管理器里 go.exe 占用不高,但磁盘 I/O 100%

解决​

首选:调低编译并发度(经验值 -p 1):

go build -p 1 ./... # 一次只编译一个包
go run -p 1 main.go

其他配套优化:

做法作用
把 Go 缓存目录加入杀毒白名单避免每次写 .a 文件被扫
go build + ./a.exe 代替 go run避免 go run 每次重新编译
改用 SSD临时目录 $TMP 走 SSD
go clean -cache清掉失效缓存
go env GOCACHE 改到大磁盘避免缓存盘满

效果实测(GPT 整理,供参考):

命令编译时间CPU磁盘压力
go run -p 8 main.go5.2s高高
go run -p 1 main.go2.1s低低

原理​

go build 默认按 runtime.NumCPU() 并发编译多个包(GOMAXPROCS 控制运行时,-p 控制编译时,两者独立)。多包并发会瞬间产生大量 .a 中间文件:

  1. Windows 杀毒软件(Defender / 360 / 火绒)实时扫描每个新文件 → IO 爆炸
  2. 机械硬盘 + 临时目录 %TEMP% 拥堵
  3. 小项目反而被并发调度开销拖累

-p 1 串行编译绕开这些问题,反而更快。

参考​


Q2.(占位)新问题追加示例​

## Q{N}. {问题标题}

### 问题
{一句话描述}

### 现象
- {关键表现 1}
- {关键表现 2}

### 解决
{命令 / 配置 / 代码改动}

### 原理
{为什么会这样}

使用说明:

  • 遇到新问题 → 复制 Q2 模板 → 填四段 → 增到本文件末尾
  • 编号 Q3 / Q4 ... 顺延
  • 不需要的小节可以省略(如纯环境问题可省「原理」)
  • 关键命令 / 报错截图可用 go build -p 1 ./... 这种行内代码块

附录:定位编译慢原因的常用命令​

# 看编译时间
time go build ./...

# 看缓存目录在哪 / 有多大
go env GOCACHE GOMODCACHE
du -sh $(go env GOCACHE)

# 看 CPU 核数
go env GOARCH
nproc # Linux
sysctl -n hw.ncpu # macOS

# 清缓存
go clean -cache # 清构建缓存
go clean -modcache # 清下载的模块缓存

# 看具体哪个包慢
go build -v -x ./... 2>&1 | tee build.log # -x 打印所有执行的子命令