应使用shift+f6（macos为⇧+f6）触发语义级重命名，光标需停在变量声明或使用处，仅更新合法引用；不可用ctrl+r文本替换，否则会误改类型、字符串、注释等导致编译失败。
直接按 Shift+F6（macOS 是 ⇧+F6），光标停在变量声明或任意一次使用处，就能触发语义级重命名——它只改这个变量的合法引用，不会误碰同名字段、类型或字符串。
为什么不能用 Ctrl+R 文本替换
手动搜替会无差别匹配所有出现位置。比如把 err 替成 parseErr，很可能顺手把 ErrInvalidToken 类型、日志里的 "err" 字符串甚至注释都改了，编译直接失败。
常见错误现象：undefined: ErrInvalidToken 或 cannot use parseErr as type error。
- 必须确保光标落在变量名上（不能停在空格、括号或字符串内部）
- 如果变量是函数参数，重命名后调用处签名会同步更新（含跨文件）
- 若弹出
Cannot refactor: reference is ambiguous，说明该名字在作用域内被遮蔽（如闭包里又声明了一次），得先理清嵌套关系
Shift+F6 默认只改当前包，跨包不生效
GoLand 依赖 gopls 做符号解析，默认作用域严格限定在当前 package 内。你在 pkg/auth 里重命名一个函数，cmd/server/main.go 中的调用不会自动更新。
要支持跨包重构，两个条件缺一不可：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 项目根目录存在
go.mod，且终端执行go list -m不报错 - Settings → Go → Go Modules 中勾选了
Enable Go modules integration
即使满足上述条件，以下情况仍会失效：
- 目标符号所在文件有语法错误（比如漏了
}），gopls解析中断 - 用了点号导入（
import . "xxx"）或匿名导入（import _ "xxx"） - 变量被局部同名声明遮蔽（如
var log = zerolog.New()后再调log.Info()）
重命名后编译失败，重点查这三处
不是工具没改全，而是有些引用它根本“看不见”：
-
反射访问：比如
reflect.Value.FieldByName("UserID")，改了结构体字段名但没同步更新字符串字面量，运行时 panic -
struct tag：重命名默认不碰
json:、db:等 tag，但人容易手抖删掉——检查type User struct { UserID int `json:"user_id"` }是否还对得上 -
interface 实现与嵌入字段：如果结构体嵌入了另一个类型，且调用走的是提升方法（如
t.Do()实际是t.embedded.Do()），改embedded的字段名可能不会触发联动
别指望一次改多个无关变量名
Shift+F6 是单符号驱动的，没有“选中一堆变量 → 批量重命名”的功能。所谓批量，其实是多次触发：
- 改完一个变量，按
Enter确认后，IDE 通常自动跳到下一个同名但不同作用域的变量（比如另一个函数里的err） - 此时可立刻再按
Shift+F6继续操作 - 想跳过某个引用（比如日志硬编码的
"err"），在重命名弹窗里取消勾选对应项即可
真正容易被忽略的是：重命名不处理 import 路径。你把目录 pkg/auth 改成 pkg/userauth，IDE 可能帮你改了 package 声明，但所有 import "myproj/pkg/auth" 还是旧的——得手动用 Ctrl+Shift+R 全局替换路径，并跑一遍 go mod tidy。
