全局搜索必须用 ctrl+shift+f（macos 为 cmd+shift+f），而非 ctrl+f；跨文件替换需用 ctrl+shift+r 并点击 replace in path…，同时注意 scope 设置、正则转义及 replace 前预览。
全局搜索用 Ctrl+Shift+F，不是 Ctrl+F
Ctrl+F 只在当前文件内查找，很多人误以为它能跨文件搜，结果改完一个文件发现其他地方漏了。真正跨目录、跨模块的全局搜索必须用 Ctrl+Shift+F（macOS 是 Cmd+Shift+F）。打开后默认范围是整个项目，但要注意右上角的 Scope 下拉框——如果选了 Current File 或 Selected Text，就退化成局部搜索了。
常见错误现象：
- 搜不到
main.go以外的文件里的变量名，其实是 Scope 被手动切到了 Current Directory - 搜到大量 vendor/ 或 go/pkg/mod/ 下的匹配项，干扰判断——应点击 Scope 右侧的
...，勾掉Exclude libraries and SDKs - 大小写敏感没关，
userID搜不出userid，需取消勾选Match case
批量替换必须用 Replace in Path，不是 Ctrl+R
Ctrl+R 仅限当前文件替换，想改几十个文件时硬切来切去极易出错。真正安全的跨文件替换入口是 Ctrl+Shift+R 打开面板后，点击左下角的 Replace in Path… 链接。
关键操作点：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Scope 必须显式选为
Project或自定义目录，不能依赖默认值（某些旧版 Goland 默认只扫 src） - 勾选
Regex前先确认正则语法正确，比如要替换所有fmt.Printf为log.Printf，搜索填fmt.Printf，点Test预览匹配效果 - 别直接点
Replace All，先点Find看完整列表，人工扫一眼前 5 条是否都该改——尤其注意字符串字面量和注释里是否误匹配 - 改完立刻运行
go mod tidy，防止 import 路径变更后编译失败
正则替换时捕获组顺序和转义容易翻车
比如想把 err := errors.New("xxx") 统一升级为 err := fmt.Errorf("xxx: %w", err)，搜索模式写成 errs*:=s*errors.New("([^"]*)")，替换写成 err := fmt.Errorf("$1: %w", err)。
这里两个坑：
- 圆括号
()和点号.在正则里有特殊含义，errors.New必须写成errors.New，否则.会匹配任意字符 -
$1对应第一个(...)里的内容，顺序写反（比如写成$2）会导致替换后为空或乱码 - 如果原字符串含换行或双引号，
[^"]*会截断，更稳妥的是用"((?:[^"\]|\.)*?)，但日常简单场景没必要过度复杂化
搜索结果太多？用 File Mask 和 Scope 精确过滤
默认全局搜索会扫 .git、vendor、testdata 等目录，噪音大。点击 Replace in Path… 面板右上角的 …，在弹出窗口中设置：
-
File mask填*.go，排除非 Go 文件 -
Scope改为Custom，然后勾选具体目录（比如只改internal/不动cmd/） - 勾选
Include tests或取消，根据是否要同步修改 *_test.go 决定 - 搜索前加
func前缀，能避开 struct 字段名和变量名的干扰匹配
最常被忽略的是 Scope 的“递归”开关：不勾 Recursively 就只查当前目录一级，子目录全跳过——这个选项藏在 Scope 设置底部，非常隐蔽。
