goland 的 rename 默认非全局生效：光标在函数内重命名变量仅作用于局部；导出标识符（首字母大写）需选“rename in project”才跨文件修改，非导出标识符仅限当前文件或作用域，且依赖正确识别 go module 和完整索引。
重命名操作触发后，为什么只改了部分地方？
GoLand 的 Refactor → Rename 默认只作用于当前文件或当前作用域，不是全局生效。如果你在函数内右键重命名一个变量，它不会自动改掉其他文件里同名的变量——哪怕它们是同一个导出的包级变量。
关键判断点：看光标位置和上下文。光标停在 func 内部时，默认范围是局部；停在包级 var 或 type 声明上，且该标识符是导出的（首字母大写），GoLand 才会弹出“Rename in file / Rename in project”选项。
- 导出标识符（如
MyVar、HTTPClient）→ 选Rename in project才能跨文件修改 - 非导出标识符（如
myVar、err）→ 只能选Rename in file或Rename in scope - 如果项目没正确识别 Go Module（缺失
go.mod或未启用 Go Modules 支持），Rename in project会灰掉或失效
批量重命名后编译报错：undefined: xxx
常见原因是 GoLand 没识别到某些引用路径，尤其出现在 vendor 依赖、replace 替换路径、或未被索引的子模块中。重命名时它默认只扫描已打开的文件 + 索引中的源码，但不会主动解析 vendor 下的符号引用。
解决方法不是反复试，而是提前确认索引状态：
- 检查右下角状态栏是否显示
Indexing...，等它完成再操作 - 执行
File → Reload project from disk确保go.mod和目录结构被重新读取 - 若用了
replace，确认对应路径存在且可访问；否则 GoLand 会跳过那些目录的引用分析 - 重命名前手动打开几个关键调用方文件（比如 main.go、test 文件），能提高索引命中率
想一次改多个不同标识符，但又不想挨个重命名
GoLand 不支持“多选后统一重命名”，但可以用 Find → Replace in Files 配合正则来绕过限制——前提是你要清楚替换边界，避免误伤。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
安全做法是加单词边界和类型限定：
\bMyOldFunc\b(?=\s*\()
这个正则只匹配后面紧跟 () 的 MyOldFunc，排除字段名、注释、字符串里的误匹配。但注意：
- 正则替换不更新函数签名，只改调用处；如果函数本身也要改名，仍需用
Rename重构 - 替换后务必运行
go build和go test ./...，Go 的类型系统会立刻暴露漏改点 - 别对
interface方法名直接正则替换——GoLand 的Rename会同步更新所有实现，而文本替换做不到
重命名后测试失败，但代码看起来没问题
最常被忽略的是测试文件里硬编码的字符串、日志输出、或反射用的名称（比如 reflect.TypeOf(x).Name()）。这些不会被 GoLand 的语义重命名捕获。
建议在重命名后快速扫一遍：
- 搜索项目中该旧名是否出现在
"xxx"字符串里（尤其是 error message、log 输出、mock 名称） - 检查是否有
reflect、unsafe或第三方序列化库（如jsontag）依赖原名 - 运行
go test -v ./... | grep -i "xxx"，看失败测试里是否暴露出残留字符串
这类问题往往不在代码逻辑层，而在数据契约或调试痕迹里，得手动盯。
