goland重构依赖精准快捷键：重命名用shift+f6（语义级）、提取函数用ctrl+alt+m（ast节点级）、改签名用ctrl+f6、改包路径用f6（目录级move），且需确保gopls启用、模块激活、无语法错误。

GoLand 的重构不是靠菜单点出来的，而是靠几个核心快捷键精准触发——用错组合、光标位置不对、项目配置没开，都会导致功能灰显或只改当前文件。

重命名必须用 Shift+F6，别用查找替换

手动 Ctrl+R 会误改 JSON key、log 字符串、struct tag 甚至其他包里的同名符号；Shift+F6 是语义级重命名，只动声明和引用，跳过字符串和注释。

• 光标必须停在标识符正中间（比如 MyFunc 的 F 上），停在末尾空格或括号内会识别失败
• 如果提示 Cannot refactor: reference found in string literal，说明某处用它当了日志字段或 API key，IDE 主动拦住你——这是保护，不是 bug
• 跨包重命名失败？先确认 go.mod 已加载、GO111MODULE=on 生效、Settings → Go → Go Modules 已勾选启用

提取函数用 Ctrl+Alt+M，光标位置决定提取范围

这个操作不弹窗框选，只处理“光标所在行”或“当前选中块”，本质是 AST 节点提取，不是文本切片。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 想提取一段逻辑，先用鼠标拖选或 Ctrl+W 扩展选择，再按 Ctrl+Alt+M
• 选区不能跨函数边界，不能含裸 return 或 panic，也不能只选 if 块里的一行赋值（得选整个 if 节点）
• 原函数有 ctx context.Context 参数？提取后新函数签名会自动带 ctx——这是设计行为，不是推断错误
• 参数太多？可能是 IDE 把本该是局部变量的值也当参数传进去了，这时先用 Ctrl+Alt+V 提取变量再试一次更稳

改函数签名用 Ctrl+F6，不是 Shift+F6

Shift+F6 只改名字，Ctrl+F6 才管加参数、调返回值、换 receiver 类型——它会同步更新所有调用点。

• 光标停在函数名上再按 Ctrl+F6，弹窗里可增删参数、改类型、设默认值（Go 不支持，填了也得手动删）
• 若某个调用用了匿名 struct 字面量传参，IDE 可能无法适配新签名，标红并提示 Incompatible arguments——得人工补字段或重构调用方
• receiver 从 *T 改成 T 时，IDE 会尝试把所有 t.Method() 改成 (*t).Method()，但如果原调用是 &t，它可能漏掉某些地方

批量改包路径用 F6（Move），不是重命名

GoLand 没有“重命名 package”功能，因为包名只是源文件顶部的静态声明；真正要改的是 import 路径，得靠目录级 Move。

• 在项目工具窗口右键整个包目录 → Refactor → Move（快捷键 F6），输入新路径（如 utils → helpers）
• GoLand 会自动：重命名目录、更新所有 import "myproj/utils"、修正类型引用（如 utils.Config → helpers.Config）、同步改 package 声明行
• 目录里混了多个包（比如同时有 package main 和 package testutil）？Move 会失败或只改部分——GoLand 要求被 Move 的目录下所有文件必须声明相同包名
• 路径和包名不一致的老项目（如路径 /v2/api 但写 package api_v2）？得先用 Replace in Path (Ctrl+Shift+R) 手动搜替 package 行和 import 路径，再跑 go mod tidy

最常被忽略的其实是项目状态：gopls 是否启用、modules 是否激活、文件有没有语法错误——这些一出问题，所有快捷键都会退化成“只改当前文件”。重构前先 go build ./ 过一遍，比反复点重命名对话框有用得多。