shift+f6重命名默认仅作用于同包内，跨包引用不会更新；需启用modules模式并确保gopls正确解析依赖树，否则仅限当前文件。
Shift+F6 重命名默认只作用于同包内
GoLand 的 Shift+F6 不是全局搜替，它依赖 gopls 的语义分析，而默认作用域严格限制在当前包（package）内。比如你在 pkg/auth 里重命名一个函数 ValidateUser，IDE 会更新该包下所有调用，但不会动 cmd/server/main.go 或 internal/handler 里对它的调用——哪怕它们 import 了这个包。
常见误判点：
- 光标停在函数名末尾空格或括号内，
gopls无法准确定位标识符，导致“无引用”提示 - 变量被局部同名声明遮蔽（如
var log = zerolog.New(...)），此时log.Info()不会被识别为标准库或外部包调用 - 目标符号所在文件有语法错误（缺失
}、未闭合字符串），gopls解析失败，重构入口直接灰掉
跨包重命名必须满足 modules 模式且路径可解析
要让 Shift+F6 覆盖跨包引用，两个条件缺一不可：go.mod 存在 + GO111MODULE=on 生效。否则 gopls 只索引当前文件，不加载依赖树。
验证方式：
- 终端进项目根目录，运行
go list -m；若报not in a module，说明 modules 未激活 - 检查
Settings → Go → Go Modules是否勾选了 “Enable Go modules integration” - 如果用了
vendor/，确认go mod vendor后没手动关闭 modules（即GO111MODULE=on仍生效）
即使满足上述条件，以下情况仍会失效：
-
replace指向本地路径但没加//go:build约束，gopls加载失败 - 用了点号导入（
import . "xxx"）或匿名导入（import _ "xxx"），引用关系无法安全推导 - 目标是 interface 方法，但弹窗没勾选 “Update implementations”（GoLand 2026.1 默认不自动更新）
重命名后 import 路径不会自动同步
改函数名、变量名、类型名，Shift+F6 能联动更新所有合法引用；但改包名、模块名、目录名，它**不负责同步 import 路径**。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
例如你把目录 pkg/auth 重命名为 pkg/userauth，IDE 可能帮你改 package 声明，但所有 import "github.com/user/proj/pkg/auth" 还是旧的——编译直接报 cannot find package。
必须手动处理：
- 用
Ctrl+Shift+R全局搜索替换"github.com/user/proj/pkg/auth"→"github.com/user/proj/pkg/userauth" - 别漏
*_test.go和internal/下的 import - 检查
go.mod中的require、replace行是否需调整 - 改完运行
go mod tidy校验路径有效性
替代方案：Replace in Path 要加 \b 单词边界约束
当 Shift+F6 因项目结构限制不可用（比如 vendor 目录下、或 GO111MODULE=off），只能退而求其次用 Replace in Path，但必须规避误替换。
安全做法：
- Scope 设为 “Project Files”
- 勾选 “Regex”，搜索模式写成
\bValidateUser\b（\b确保只匹配完整单词） - 关闭 “Case sensitive” —— Go 标识符大小写敏感，但确保没漏小写形式（如字段名可能小写）
- 先点 “Find”，人工检查前 10 个结果：排除字符串（
"ValidateUser"）、注释（// call ValidateUser）、第三方包路径（github.com/xxx/yyy.ValidateUser）
真正难的是判断哪些引用该改、哪些不该动——尤其当多个模块共用同名标识符时，IDE 不会替你做语义区分，这一步只能靠人盯。
