GoLand缓存清理需分三类处理：安全删$GOCACHE（用go clean -cache），禁手动删$GOPATH/pkg/mod，IDE索引缓存优先用Invalidate Caches重启；误删或混用会导致构建变慢、符号解析失败。
GoLand 缓存清理：哪些该删、哪些不能碰
GoLand 的缓存分三类：Go 构建缓存（$GOCACHE）、IDE 自身索引缓存、模块依赖缓存（$GOPATH/pkg/mod）。删错地方会导致构建变慢、符号解析失败，甚至 go mod download 重拉全部依赖。
-
go clean -cache安全清空$GOCACHE（默认在~/Library/Caches/go-build或%LOCALAPPDATA%\go-build），首次构建略慢，之后恢复，体积回到 KB 级 -
go clean -fuzzcache只在用go test -fuzz时才需执行，日常开发可忽略 - 绝对不要手动删
$GOPATH/pkg/mod—— 这是 Go Modules 的只读缓存，删了下次go mod download会卡住或报 checksum mismatch - GoLand 自身的索引缓存（如
~/.cache/JetBrains/GoLand*/caches）可整目录删除，但更推荐用 IDE 内置方式：File → Invalidate Caches and Restart → Invalidate and Restart
Build project automatically 关掉后为什么还“偷偷编译”
关掉 Build project automatically 只停掉了保存即构建的触发器，但 GoLand 底层仍会周期性调用 go list 做包结构分析，只要 gopls 活着，它就可能往 $GOCACHE 写东西。这不是 bug，是语言服务器维持语义理解的必要行为。
- 路径：
Settings → Go → Language Server → Build tags & ignore patterns，在build.ignore里加pkg/**和bin/**，能阻止gopls对这些目录做分析，减少误触发 - 真正禁用所有自动构建行为，还得去
Settings → Tools → File Watchers，关掉所有带go字样的 watcher（比如go fmt、go vet） - 如果项目没开 Go Modules，
gopls会 fallback 到 GOPATH 模式扫描，此时build.ignore失效——必须先go mod init
环境变量改了但 go env 不变？检查这三层作用域
GoLand 启动时读取环境变量有三个独立来源：系统 shell 启动时加载的（如 .zshrc）、IDE 项目级配置（Settings → Go → Go Environment）、Run Configuration 模板（Templates → Go Build）。改一处不等于全生效，尤其 macOS 用户从桌面图标启动时，.zshrc 根本不加载。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 验证当前终端真实环境：
go env | grep -E "(GOROOT|GO111MODULE|GOPROXY)"，若和系统不一致，说明 IDE 是从 GUI 启动而非 shell，得去Settings → Tools → Terminal → Shell path勾选 Activate environment variables from project configuration - 项目级配置改完必须重启 GoLand，否则已打开的 Terminal 或 Run Configuration 仍用旧缓存值
- 新建 Run Configuration 默认继承
Templates → Go Build的设置，这里若开了Include system environment variables，就会把APP_ENV=prod这类业务变量也带上——很多调试失败就因为这个开关被悄悄打开了
缓存清理后符号仍不更新？可能是 .a 文件没刷掉
Go 在 GOPATH 模式下会把 go install server 编译出的 .a 归档文件缓存在 $GOPATH/pkg/ 下，go build main.go 会优先链接它，而不是重新编译源码。这就是你改了 server/server.go 却提示 undefined: foo.MyName 的根本原因。
- 查缓存是否存在：
ls $GOPATH/pkg/$(go env GOOS)_$(go env GOARCH)/github.com/yourname/server.a - 强制刷新依赖：
go install ./（注意是./，不是main.go），它会递归编译当前目录下所有包并更新.a文件 - 终极解法：迁移到 Go Modules，
go build .不再依赖$GOPATH/pkg，所有构建都基于当前源码树，彻底绕过这个坑
真正的麻烦不在缓存位置本身，而在不同缓存之间的作用边界：Go 的 $GOCACHE、IDE 的索引、gopls 的分析状态、Go Modules 的 pkg/mod，它们各自生命周期不同、刷新条件不同。一次清理操作只影响其中一层，想“彻底干净”，得先确认你要解决的是哪一层的问题。
