goland 中用 structural search（ctrl+shift+alt+s）按 ast 模式搜索结构相似代码，如 if $err$ != nil { return $err$ }，支持变量占位符与类型约束，需启用递归搜索、精准语法匹配，并配合 structural replace（ctrl+shift+alt+r）批量替换。
GoLand 里怎么搜“长得像”的代码，而不是字面匹配？
直接用 Ctrl+Shift+F 全局搜索只能找完全一致的字符串，想定位结构相似、逻辑雷同但变量名或空格不同的代码（比如多个地方都写了 if err != nil { return err } 变体），得靠 GoLand 的「Structural Search」——它按 AST 模式匹配，不是字符串匹配。
打开方式：Ctrl+Shift+Alt+S（Windows/Linux）或 Cmd+Shift+Alt+S（macOS），或者从菜单选 Search → Structural Search…
- 新建模板时语言选
Go，别选错成Plain text或Java - 写模式表达式要贴 Go 语法：比如匹配任意错误检查，可写
if $err$ != nil { return $err$; }，其中$err$是变量占位符，支持类型约束（右键它 → Edit Variables… → 设置Type text为error） - 默认不递归匹配嵌套语句，如果想捕获带 else 的完整 if 块，得手动勾选 Whole words only 下方的 Search in comments 和 Case sensitive（视需开启），更重要的是在模板编辑区点右上角 … → Edit template settings → Enable recursive search
为什么写对了 pattern 却搜不到？常见匹配失败原因
Structural Search 对语法结构敏感，稍有偏差就静默失败——它不会报错，只是返回空结果，容易误以为没匹配到。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
return后面多了一个换行或空格？不行。GoLand 的 AST 匹配要求语句层级和 token 序列基本一致，return $err$不会匹配return\n$err$ - 用了类型推导的短变量声明？比如
err := doSomething()，不能用if err != nil直接匹配——因为 AST 中err在这里是Define节点，不是Identifier；得拆成两个模板：一个搜:=赋值，另一个搜后续的if块，并用 Script constraint 关联变量名 - 函数调用带多行参数？默认只匹配单行形式。需要在变量设置里把
Minimum/Maximum count设为0..*，并勾选 Within same line 的反选（即允许跨行）
搜完怎么批量替换相似代码？
Structural Search 本身不带替换，但它的孪生功能 Structural Replace（快捷键 Ctrl+Shift+Alt+R）可以。关键在于：替换模板里的占位符必须和搜索模板严格对应，包括名字和约束条件。
- 例如搜到了
if $err$ != nil { return $err$ }，想统一改成if !errors.Is($err$, context.Canceled) && $err$ != nil { return $err$ }，就得确保替换模板中$err$的类型约束和原模板一致（否则可能把非 error 类型也套进去） - 替换前务必点 Preview，GoLand 会列出所有候选位置并高亮变更差异；注意看是否误伤了
if x != nil这类非 error 场景——这时候得回退，在搜索模板里给$err$加上Type text: error约束 - 涉及跨文件替换时，
Scope别漏选 Project，默认可能是 Current file
替代方案：用正则 + 文件过滤快速兜底
Structural Search 学习成本高，临时应急或搜简单变体时，用 Ctrl+Shift+F 开启正则模式更直接。
- 搜所有 error 返回模式：
if.*?!=\s*nil\s*\{.*?return.*?;\s*\}，记得勾选 Regex 和 Case sensitive（Go 关键字小写，大小写敏感能避干扰） - 但正则无法识别作用域，容易跨函数误匹配。所以一定要配合 File mask 过滤，比如填
*.go，再点右边 … 加限制：!vendor/**, !test/**排除无关路径 - 如果发现结果太多，加个上下文锚点：比如只找
func开头后 5 行内的匹配，这时得切到 Find in Path 的 Scope → Custom → 写func.*\n.{0,200}if.*!=.*nil这类带行数控制的正则（注意.默认不匹配换行，要开 Dot matches newline）
Structural Search 强大但娇气，正则灵活却易误伤——真正用熟的人，通常先用正则扫一遍大致范围，再挑典型样本转成 structural 模板做精准治理。变量命名风格不统一、error 处理夹杂日志或重试逻辑的地方，最容易漏掉约束条件，动手前最好先用 Parse tree（在编辑器右键 → Inspect Code → Show parse tree）看看目标代码真实的 AST 结构。
