goland不支持用户编写任意逻辑的自定义重构规则，仅提供预置语义重构；可配置项限于settings→editor→general→refactorings和settings→go→refactorings两处，用于调整行为边界（如跨包重命名、测试文件引用更新、注释字符串搜索等），而非脚本扩展。
GoLand 里怎么启用自定义重构规则
GoLand 本身不支持用户编写或导入任意逻辑的“自定义重构规则”（比如正则批量重命名、条件提取函数），它只提供预置的、语义感知的重构能力。所谓“自定义”，实际是指在预设框架内调整行为边界和触发条件，而不是写脚本扩展功能。
真正可配置的入口只有两处：Settings → Editor → General → Refactorings 和 Settings → Go → Refactorings。前者控制通用行为（如是否自动重命名引用、是否预览变更），后者影响 Go 特有逻辑（如是否跨包重命名、是否更新测试文件中的调用）。
- 勾选
Search in comments and strings后，Rename Symbol会连带修改注释和字符串里的文字匹配——但仅限字面量一致，不会做语义替换 -
Update references in test files默认关闭；若项目中测试与实现强耦合（如 table-driven 测试里硬编码函数名），建议打开 - Go 设置页中的
Use fully qualified name for cross-package references影响提取函数后生成的调用路径：关掉它会让新函数调用走相对导入，适合单模块项目；打开则强制用pkgname.FuncName，利于跨模块复用
为什么“提取函数”有时不识别你的代码块
不是所有选中区域都能被 GoLand 当作合法重构目标。gopls 的 AST 解析器对代码结构有硬性要求，一旦越界就直接禁用菜单项（灰掉），不会报错提示。
常见失效场景：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 选区跨了
func边界（比如从一个函数开头拖到另一个函数中间）——gopls 认为这不是单一作用域内的逻辑片段 - 代码块里含
return、break、goto或defer——这些语句依赖原始函数上下文，抽离后语义可能改变 - 变量作用域不闭合：比如选中了
if x > 0 { y := 1 }但没包含y的后续使用，gopls 拒绝提取（避免引入未定义变量） - 存在类型推导失败：当
:=右侧是泛型调用或 interface{} 赋值，且无显式类型标注时，gopls 可能无法推断返回类型，导致提取按钮不可用
重构前必须检查的三个 gopls 状态点
哪怕快捷键没灰，操作仍可能静默失败或只改当前文件——根源常在 gopls 服务状态异常。别跳过这三步验证：
- 底部状态栏是否显示
gopls ready？如果卡在loading或报no module found，说明项目没正确识别为 Go Modules，需确认根目录有go.mod且GO111MODULE=on生效 - 右键任意标识符 →
Go to Declaration是否能跳转？跳不到 = gopls 未解析成功，大概率是go.mod里某个依赖拉取失败（go list -m all报错） - 执行
Go: Restart Language Server后，观察Help → Show Log in Explorer里最后 10 行有没有invalid identifier或parse error——这类语法问题会让 gopls 拒绝处理整个文件的重构请求
批量清理重复逻辑的替代方案
当项目里存在大量结构相似但参数/字段名不同的重复代码块（比如十几个 HTTP handler 都在做类似的 JWT 解析 + 权限校验），GoLand 的单点重构效率极低。这时应放弃“手动提取”，转向工程化手段：
- 用
Find Usages（Alt+F7）定位所有相似模式，再配合Replace in Files（Ctrl+Shift+R）做安全替换：先搜token, err := parseJWT(.*?); if err != nil \{，再替换成统一中间件调用 - 写一个轻量级
go:generate工具：把重复逻辑抽象成模板，用text/template生成标准校验函数，确保每次生成结果一致 - 对已存在的重复代码，优先用
Extract Interface（Ctrl+Shift+I）反向建模：选中一个 handler 实现 → 提取接口 → 让其他 handler 实现同一接口，后续维护只需改接口定义
真正的“高效清理”不靠点击次数少，而在于让重复逻辑失去存在理由——要么收编进统一抽象，要么用生成代替手写。gopls 的重构能力再强，也救不了设计层面的散装代码。
