goland自动重构需gopls启用且项目处于modules模式，否则shift+f6、ctrl+alt+m等仅作用于当前文件或灰显；重命名要求光标精准定位标识符、无语法错误；提取函数受ast边界约束，禁止跨函数、含return或局部块；批量重构须用ast脚本。
GoLand 的自动重构功能默认不生效，必须确认 gopls 已启用且项目处于 Go Modules 模式，否则 Shift+F6、Ctrl+Alt+M 等操作只会作用于当前文件或直接灰掉。
确认 gopls 启用且 modules 模式已激活
GoLand 自带 gopls，但不会自动开启模块感知。若项目根目录没有 go.mod，或 GO111MODULE 环境变量未设为 on，所有跨包重构（如重命名被其他包 import 的函数）都会静默失败。
- 终端执行
go list -m：若报错not in a module，说明 modules 未激活 - 运行
go mod init example.com/myapp生成go.mod - Settings → Go → Go Modules → 勾选
Enable Go modules integration - 若使用
vendor/，确保go mod vendor后未手动关闭 modules（GO111MODULE=on必须生效）
重命名（Shift+F6）为什么只改了当前文件？
常见误判不是配置问题，而是符号识别失败或作用域限制。gopls 只索引当前 workspace 中可解析的代码，不处理外部模块源码。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 光标必须停在标识符**正中间**（比如
MyFunc的F上），停在末尾空格或括号内会识别失败 - 局部变量遮蔽标准库时无效：如
var fmt = &log.Logger{}后，fmt.Println不会被视为标准库调用 - 目标符号存在语法错误（如缺失右括号、字符串未闭合），
gopls解析失败，重构入口直接灰掉 - 安全做法：先执行
go build ./确保无编译错误，再触发Shift+F6
提取函数（Ctrl+Alt+M）失败的三个 AST 边界硬约束
GoLand 的 Extract Function 是基于 AST 分析，不是文本切片。它拒绝任何破坏语法树结构的选中方式。
- 选区不能跨函数边界：比如在
func A()里选中一段代码，其中包含对func B()的调用，但没把整个B函数体选进去 - 不能含裸
return或panic：新函数无法推导返回类型，会报错cannot use … as type … in return statement - 不能只选 if/for/defer 的局部块：必须选中完整节点，例如只选
if x > 0 { y = 1 }中的y = 1会失败；要选整个if节点 - ctx 参数默认注入：若原函数有
ctx context.Context参数，提取后会自动加到新函数签名中——这是设计行为，非 bug
批量重构不能靠点击，必须写 AST 脚本
GUI 重构只支持单点、单文件、单符号粒度。想把全项目 log.Print* 替换为 zerolog，或统一升级 error wrapping 方式（fmt.Errorf → fmt.Errorf("%w", err)），IDE 本身不提供条件过滤和跨文件能力。
- 绕不开
go/ast+go/parser+go/format三件套 - 必须走 AST 解析：字符串替换会误改注释、字符串字面量、局部变量遮蔽场景
- 替换后需手动处理导入：用
astutil.AddImport补"github.com/rs/zerolog"，否则编译失败 - 并发处理多文件时，建议单 goroutine 顺序执行，避免文件覆盖或状态竞争
最常被忽略的一点：即使所有配置都对，只要当前文件里有未解析的导入（比如 import "github.com/bad/path" 且该模块不可下载），gopls 就无法构建完整 AST，此时所有重构入口都会不可用——这不是 bug，是保护机制。
