“重命名模块”必须在go.mod里操作，因为go模块路径是编译期符号，直接搜索替换会遗漏import、require、go.sum等多处关联内容，导致构建失败；正确做法是通过goland shift+f6重命名module声明并自动同步所有位置。
为什么“重命名模块”必须在go.mod里操作，而不是全局搜索替换
因为Go模块路径是编译期符号的一部分，不是字符串字面量。直接搜索替换github.com/old-org/project会漏掉import路径、go.mod中的require、vendor校验哈希，甚至go.sum里的checksum行——这些地方一旦不一致，go build会报cannot load github.com/old-org/project: module github.com/old-org/project@latest found, but does not contain package。
正确做法是：在go.mod第一行的module声明上按Shift+F6（macOS）或⇧F6（Windows/Linux），勾选“Search in comments and strings”，让GoLand自动同步更新所有关联位置。它还会校验replace和exclude语句是否需要调整。
- 如果项目用了
replace指向本地路径，重命名后要手动检查路径是否仍有效 - 私有仓库迁移后，记得同步更新
GOPRIVATE环境变量，否则go get会走代理失败 - 重构预览窗口里，右键某处“Exclude from Refactoring”可跳过特定注释或测试用例里的硬编码路径
Extract Method时，为什么参数列表总比预期多一个ctx
GoLand默认把context.Context视为“隐式依赖”，只要函数签名里有ctx context.Context，且调用链上游也传了ctx，它就会自动把ctx加进新提取函数的参数里——哪怕你选中的代码块本身没直接用到ctx。这不是bug，是设计行为，目的是保证提取后的函数仍能参与超时控制和取消传播。
如果你确定这个子逻辑不需要上下文（比如纯内存计算、JSON序列化），可以在弹出的提取对话框里手动删掉ctx参数，但要注意：后续调用方必须补上context.Background()或显式传入ctx，否则编译报错not enough arguments in call to xxx。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 选中代码前先确认光标所在函数是否有
ctx参数，有则默认带入；没有则不会出现 - 若想禁用该行为，进入
Settings > Editor > General > Refactorings > Extract Method，取消勾选“Include context.Context parameter” - 提取后立刻运行
go vet -all，检查是否因遗漏ctx导致取消信号丢失
老项目里大量if err != nil嵌套，怎么用GoLand批量解耦
GoLand本身不提供“一键扁平化错误处理”的重构，但可以组合使用Extract Method和Inline快速拆分。关键不是消除if，而是把错误分支逻辑从主干剥离，让主流程聚焦业务。
典型操作：选中if err != nil { log.Fatal(err); return }整块，按Ctrl+Alt+M提取为handleFatalError；再选中if err != nil { return err }，提取为returnOnError。这样主函数就变成if err := doX(); err != nil { return onError(err) }，可读性立升。
- 不要对整个
func做提取，容易把正常逻辑也裹进去；只选中if语句及其内部动作 - 提取后立即检查新函数是否被其他地方误调用——GoLand默认设为
private，但若原函数在包外被引用，需手动改handleFatalError为handleFatalError - 如果项目已升级到Go 1.26+，建议后续用
go fix统一转成errors.AsType风格，避免手写重复判断
索引卡死、跳转失效时，重建索引的最小代价操作
GoLand 2026.1.1的索引引擎虽快，但遇到vendor/目录混杂、go.work多模块未对齐、或GOROOT切换频繁时，仍可能进入“半索引”状态：部分文件能跳转，部分报Cannot find declaration to go to。此时不用全量重建，优先执行三个轻量操作：
第一步：在Project视图右键根目录 → Reload project，强制刷新module graph；第二步：打开Help > Diagnostic Tools > Debug Log Settings，输入go.index开启索引日志，看是否卡在某个第三方包；第三步：仅对出问题的目录右键 → Reload from Disk，而非整个项目。
- 全量重建索引（
File > Reload project from disk）会清空所有缓存，耗时可能达数分钟，仅在上述三步无效时才用 - 如果日志显示卡在
golang.org/x/...，检查GOPROXY是否配置正确，或临时设为direct绕过代理 - WSL2环境下，确保
Settings > Go > GOPATH指向Linux路径而非Windows映射路径，否则索引会反复失败
git diff逐行确认。
