GoLand重构需启用Modules模式并确保gopls正常索引，否则Shift+F6仅限当前文件、Ctrl+Alt+M提取函数灰显；重命名不跨包，提取受AST约束禁止跨控制流，批量重构须自定义AST脚本。
GoLand 的重构能力不是开箱即用的“全项目生效”，必须手动激活 modules 模式并确保 gopls 正常索引，否则 Shift+F6 重命名只改当前文件，Ctrl+Alt+M 提取函数会直接灰掉。
必须启用 Go Modules 集成，否则重构仅限单文件
GoLand 自带 gopls，但默认不自动识别模块——即使项目里有 go.mod，若 Settings → Go → Go Modules 中未勾选 “Enable Go modules integration”，所有跨包重构（如重命名被其他包 import 的函数）都会失效。
- 验证方式：在项目根目录终端运行
go list -m；若报错not in a module，说明 modules 未激活 - 补救操作：执行
go mod init example.com/yourproject生成go.mod，再回 IDE 勾选该选项 - 若使用
vendor/，需确认GO111MODULE=on仍生效（go mod vendor不会自动关 modules）
重命名（Shift+F6）默认不跨包，别指望它自动更新外部模块引用
gopls 只解析当前 workspace 内可加载的源码。你改了 utils.FormatName()，但另一个 Git 仓库里 import "github.com/other/repo" 也调用了它？Shift+F6 不会碰那里的代码。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 常见失败信号：光标停在函数名末尾空格或括号内，
gopls无法准确定位标识符 - 遮蔽陷阱：局部变量声明了同名
var json = &bytes.Buffer{}，会导致json.Marshal被识别为变量调用而非标准库 - 安全前提：务必先运行
go build ./确保无语法错误；有未闭合字符串或缺失右括号时，AST 解析失败，重构入口直接禁用
提取函数（Ctrl+Alt+M）受 AST 结构严格约束，不是文本切片
它基于抽象语法树分析，拒绝任何破坏控制流完整性的选区。选中部分 if 分支、跨 for 循环边界、或含裸 return 的代码块，都会触发“无法提取”提示。
- 典型失败场景：只选了
if err != nil { return err }中的return err，没包含整个if节点 - defer 内部代码无法提取——AST 认为它属于外层函数的延迟上下文，不能独立成函数
- workaround：手动补全逻辑结构（例如把整个
if块选中），或拆成更小、无控制流中断的表达式再提取
批量跨文件重构不存在 GUI 入口，必须写 AST 脚本
想把全项目所有 log.Printf 替换为 logger.Info，或统一把 fmt.Errorf("xxx") 改成 fmt.Errorf("xxx: %w", err)？GoLand 的图形界面不支持条件过滤和跨文件批量操作。
- GUI 重构仅支持单符号、单文件粒度（如 Rename Symbol、Extract Function）
- 真实批量需求需依赖自定义 AST 脚本（例如用
gofumpt或goast库遍历节点），正则替换极易误伤注释或字符串字面量 - 临时方案：用
Find in Path（Ctrl+Shift+F）配合正则log\.Printf\((.*?)\)定位，但替换后必须人工逐个验证
最易忽略的是：每次切换 Go 版本或拉取新分支后，gopls 缓存可能未刷新，导致重构行为异常——此时需手动触发 “Restart Language Server”（Help → Find Action → 输入 restart language server），而不是反复检查快捷键是否按对。
