如何在IntelliJ中创建TypeScript相对导入检查？尝试结构搜索未生效

核心原因 #

Structural Search（结构搜索）是基于代码语法结构的搜索，不是纯文本匹配，所以输入不完整的语法片段、纯字符串或者孤立关键字（比如单独的from）都无法匹配到合法的import语句节点。

正确配置步骤 #

1. 确认目标语言
   在结构搜索对话框顶部，选择你当前使用的语言（比如JavaScript/TypeScript），选错语言会导致语法解析失败，完全搜不到结果。

2. 使用合法的语法模板
   要匹配以../开头的相对路径import，使用符合ES模块语法的完整模板：

   import $imported$ from '../$path$';
   

   • $imported$：作为导入内容的占位符，可设置为「Accept any text」（接受任意内容，支持默认导出、命名导出等变体）
   • $path$：作为路径后缀的占位符，若要约束路径格式，可在占位符属性中设置「Text regexp」为[^']+（匹配单引号内的任意字符），确保只匹配../开头的路径。

   如果需要匹配更多import变体（比如命名导入、无分号结尾），可以调整模板为更宽松的结构：

   import $imports$ from '../$path$'
   

   并将$imports$的类型设置为「ImportClause」（IDE会自动识别所有合法的导入语法）。

3. 排查常见错误

   • 不要给模板加额外引号（比如"from '../"）：这会被解析为字符串字面量，而非import语句的一部分。
   • 不要输入孤立关键字（比如单独的from）：结构搜索需要完整的语法节点，孤立关键字不属于合法的语法单元。
   • 检查搜索范围：确保目标文件没有被IDE排除（比如node_modules、构建产物目录），若索引未更新，可执行「File → Invalidate Caches...」刷新索引。

内容的提问来源于stack exchange，提问作者Roger C S Wernersson