goland重构菜单位于顶部refactor菜单及右键上下文，最常用操作是rename、extract function和change signature；需先选中变量名、函数名等有效目标，否则选项置灰。
重构菜单在哪找，哪些操作最常用
GoLand 的重构功能不是藏在右键菜单深处，而是集中在 Refactor 顶部菜单和右键上下文里——但得先选中有效目标：变量名、函数名、结构体字段、包路径，甚至整个 func 块。没选中就点 Refactor 菜单，大部分选项是灰的，不是软件卡了，是它根本不知道你要重构啥。
最常被用到的三个操作：Rename（重命名）、Extract Function（提取函数）、Change Signature（修改函数签名）。其他像 Move、Inline 用得少，但一旦需要迁移一个 struct 到另一包，或干掉一个只用一次的 var，它们就不可替代。
重命名（Rename）为什么有时不生效
Rename 看似简单，但 GoLand 默认只重命名当前文件内可见的引用，除非你勾选了 Search in comments and strings 和 Preview usages。更关键的是：如果目标符号来自外部模块（比如 github.com/some/pkg），GoLand 不会动它的源码，只改你本地 import 或调用处——这没错，但容易误以为“没重构成功”。
- 跨文件重命名要求项目已正确解析
go.mod，且没有go list错误；否则Rename只作用于当前文件 - 重命名
func时，若该函数被interface实现，GoLand 不会自动更新接口定义——得手动检查并同步改type MyInterface interface { ... } - 别对
_（空白标识符）或init函数用Rename，会直接报错：Cannot refactor this element
提取函数（Extract Function）的边界怎么划
选中几行代码 → 右键 → Refactor → Extract Function，GoLand 会帮你生成新函数，但生成结果是否合理，取决于你选中的范围是否满足“可独立执行”：不能跨 defer、不能拆开 for 循环体、不能把 return 半截拎走。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
常见翻车点：
- 选中含
return err的片段，但没把前面的err := ...一起选，新函数会报undefined: err - 提取后参数过多（>5 个），GoLand 默认全塞进参数列表，不如手动删掉几个，改用结构体传参更清晰
- 如果原代码在
main()或测试函数里，提取出的函数默认是 unexported（小写开头），想跨包用得手动改成大写，并补上go doc注释
修改函数签名（Change Signature）改完为啥调用处没更新
Change Signature 支持增删参数、改类型、调换顺序、加默认值（Go 不支持默认值，所以这一项实际被禁用），但它依赖 GoLand 正确识别所有调用点。如果某个调用在 test 文件里，而你没打开对应 _test.go，或者调用在 build tag 条件编译块里（如 //go:build !windows），GoLand 就可能漏掉。
安全做法：
- 操作前确保所有相关
.go和.go文件都处于打开状态，尤其是同包下的xxx_test.go - 勾选
Preview changes，别跳过——它会列出每个将被修改的调用位置，一眼能看出有没有漏掉的if build分支 - 改完发现某处调用仍报错，八成是那行用了旧签名，但 GoLand 没扫到；此时手动删掉那行再
Ctrl+Space补全，比硬等自动修复快
重构不是魔法，它靠 AST 解析，也受 go mod 状态和编辑器缓存影响。改完多跑一遍 go vet 和 go test，比盯着预览窗口更可靠。
