gopls 启动慢或卡住的主因是goland默认使用旧版go插件及gopls配置不当：需禁用completeunimported/deepcompletion、关闭watchfilechanges、排除无关module扫描，并停用windows的pcmanager service。
gopls 启动慢或卡住是主因
GoLand 默认用旧版 Go 插件做代码提示，它不支持增量索引、无法跨 module 高效跳转，且会反复扫描 vendor/ 或 replace 路径。真实瓶颈往往不是网络或 CPU，而是 gopls 进程启动时卡在 go list -mod=readonly -e -json -deps 这一步——尤其当项目含大量 replace、本地路径或嵌套 module 时，单次扫描可能耗时 2–5 秒。
实操建议：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确认 gopls 是否真在运行：在 GoLand 的 Help → Diagnostic Tools → Debug Log Settings 中添加
gopls，重启后看日志里是否有starting gopls但无后续 - 强制指定 GOPATH 和 GOROOT：在 Settings → Go → GOROOT / GOPATH 中手动填入绝对路径，避免 gopls 自动探测失败
- 禁用无关 module 扫描：在 Settings → Go → Modules 中勾选
Exclude modules outside of GOPATH（若不用 go work） - 删掉
go.work文件（如果存在但没被需要）：gopls 对 workspaces 支持仍不稳定，多 module 切换易触发全量重索引
gopls 配置必须关掉这几个开关
默认配置里 completeUnimported 和 deepCompletion 看似增强提示，实际会让 gopls 每次都去 resolve 全局 symbol 表，尤其在大型项目中直接拖慢到 3–4 秒才出提示。这不是“功能越强越慢”的合理权衡，而是设计缺陷——它们在非编辑态就预加载未导入包的 AST。
实操建议：
- 在 Settings → Languages & Frameworks → Go → Go Tools 中，取消勾选
Autocomplete unimported packages（对应completeUnimported: false） - 关闭
Deep completion（对应deepCompletion: false），这个选项对泛型类型推导几乎无用，却让每次 completion 多扫一遍所有依赖 module - 把
watchFileChanges设为false：GoLand 本身已监听文件变更，gopls 双重监听反而引发 index 冲突和 reload 卡顿 - 确保
usePlaceholders保持true：它只影响函数参数占位符生成，开销可忽略，且能减少手动补全次数
Windows 下 PCManager Service 是隐藏杀手
2025 年中后期 Win11 更新引入的 PCManager Service（也叫 MSPCMANAGER 或 MSMANAGER）会劫持所有 Go 工具链进程（包括 gopls、go list、go build），强制进行签名验证与内存扫描。它不报错，但会让 gopls 初始化延迟从 800ms 涨到 3.2s+，且表现为 CPU 占用忽高忽低、磁盘 I/O 持续抖动。
实操建议：
- 按
Win + R输入services.msc，找到PCManager Service或名称含MS/Manager的服务，右键停止并设为“手动”启动 - 不要直接删注册表项——该服务关联 Microsoft Store 更新机制，停用即可，不影响日常使用
- 验证是否生效：打开终端执行
gopls version，正常应在 200ms 内返回；若仍 >1s，再检查杀毒软件是否把gopls.exe加入实时扫描白名单
module 依赖爆炸时得砍掉冗余 import
gopls 的 completion 延迟和当前文件 import 的 module 数量呈近似线性关系。一个 handler 文件里 import 了 github.com/gin-gonic/gin、github.com/go-sql-driver/mysql、google.golang.org/grpc 三个重型 module，gopls 就得同时加载它们的全部 types，哪怕你只打 http.。
实操建议：
- 把非核心逻辑拆到独立 package：比如把 DB 操作封装进
pkg/db，HTTP handler 只 importpkg/db而非直接 importmysql - 用
_替代未使用的 import：GoLand 不会为下划线导入提供补全，但能减少 gopls 加载负担 - 检查
go.mod里有没有残留的replace指向本地未 commit 的 repo——gopls 会尝试读取其go.sum，而本地路径缺失时会卡住 2s+ 等超时 - 禁用 GoLand 的
Auto-import（Settings → Go → Code Editing → Imports）：它会在你敲fmt.时自动加 import，但背后触发了一次完整符号查找，打断输入流
