Import-Helper插件不读tsconfig.json的paths，需手动配置pathMappings；默认优先相对路径，应按前缀长度和顺序设置别名；monorepo需显式声明跨包路径；配置后须重载窗口、确认语言模式、检查插件诊断。
Import-Helper插件不识别tsconfig.json的paths别名
它压根不读 tsconfig.json 或 jsconfig.json 里的 compilerOptions.paths，这是最常被误以为“配置了却没用”的根源。插件只按自己规则扫描文件系统，不会主动解析 TypeScript 配置。
必须手动在 VSCode 设置里补全映射关系：
- 打开设置（
Ctrl+,），搜import-helper.pathMappings - 点「Edit in settings.json」，添加类似这样的块：
{
"import-helper.pathMappings": {
"@": "${workspaceFolder}/src",
"@utils": "${workspaceFolder}/src/utils",
"api": "${workspaceFolder}/src/api"
}
}
${workspaceFolder} 是唯一安全的变量；写成 ./src 或绝对路径会导致换机器失效。
为什么自动导入总选错层级，比如从 src/pages/Home.tsx 导入 Button 却生成 ../../components/Button 而不是 @/components/Button
插件默认优先使用相对路径，除非你明确告诉它哪些别名更“高级”。它没有内置优先级判断逻辑，只按 pathMappings 字典顺序匹配最长前缀。
关键操作是调整映射顺序和粒度：
- 把更宽泛的别名（如
@）放在前面，更具体的（如@components）放后面 - 避免重叠：不要同时配
@和@/components，否则@/components/Button可能被截成@/components+Button，再拼出错误路径 - 如果项目中大量使用
@components，直接配"@components": "${workspaceFolder}/src/components"，比依赖@+ 相对拼接更稳
monorepo 下 Import-Helper 导入跨包模块失败
它只认当前 ${workspaceFolder}，不会自动向上找 ../packages 或解析 pnpm 的 symlink。即使 node_modules 里有链接，插件也不走那条路。
必须显式声明跨包路径：
- 例如从
apps/web导入packages/ui，在apps/web文件夹下的settings.json中加：
{
"import-helper.pathMappings": {
"@ui": "${workspaceFolder}/../packages/ui"
}
}
注意：${workspaceFolder} 指的是你当前打开的文件夹（即 apps/web），不是整个 monorepo 根目录。如果打开的是根目录，则需用 ${workspaceFolder}/packages/ui。
重启后配置仍不生效的三个硬性条件
这个插件的配置不是热加载的，漏掉任一环节都会白配：
- 改完
settings.json后必须重载窗口（Ctrl+Shift+P→Developer: Reload Window），关标签页没用 - 确保当前文件的语言模式正确——
.tsx文件右下角显示的是TypeScript React，不是Plain Text或JavaScript - 确认插件本身启用且无报错：命令面板运行
Import Helper: Show Diagnostics，看输出里有没有Failed to resolve mapping类错误
最容易被忽略的是语言模式错位和重载不彻底——后台进程残留会导致新配置完全不加载。
