Path Intellisense是唯一可靠的路径补全插件，需在VSCode市场搜索“path-intellisense”（带连字符）、作者Christian Kohler、安装量超600万；必须启用“Path Intellisense: Enabled”和“Auto Surround”，且通过“Open Folder”打开项目，否则不生效。
Path Intellisense 插件是唯一可靠的选择，装“Path”插件没用——VSCode 市场里根本不存在叫 Path 的有效路径补全扩展。
确认装的是真 Path Intellisense
在 VSCode 扩展市场搜 path-intellisense（带连字符），作者必须是 Christian Kohler，安装量超 600 万。装完后不用重启，但右下角不会显示图标；敲 import "@/ 或 src="./ 时引号内应立刻弹出建议。其他名字带 “path” 的扩展（如 Path Helper）基本已停更或功能残缺。
Path Intellisense: Enabled 和 Path Intellisense: Auto Surround 必须都开启
装完不生效？90% 是这两个开关没开：
-
Path Intellisense: Enabled—— 主控开关，关了就彻底静默 -
Path Intellisense: Auto Surround—— 决定是否在输入"或'后自动弹建议；不勾选就得手动按Ctrl+Space
打开设置（Ctrl+,），直接搜 path-intellisense 就能定位到这两项。
别名路径（如 @/utils）补不全？三处硬性校验一个不能少
插件不会猜别名指向哪，它只读配置。缺一不可：
- 项目根目录存在
tsconfig.json或jsconfig.json，且含"baseUrl"和"paths"（例如"@/*": ["src/*"]） -
path-intellisense.mappings设置为空（推荐），或与tsconfig.json中的paths严格一致（斜杠方向、路径拼写、通配符都要对） - 执行命令面板里的
Developer: Restart TS Server—— 否则旧缓存还在，改了配置也白搭
Windows 用户注意：paths 里必须用 /，别写 \；插件会自动适配系统分隔符。
JSON 文件里路径字段没提示？不是插件问题，是语义缺失
package.json 里的 "main": ""、"types": "" 这类字段默认不被识别为路径上下文。要让它生效，得靠 json.schemas 显式声明：
- 在
.vscode/settings.json里加配置，指向官方 schema（如"url": "https://json.schemastore.org/package"） - 自定义 schema 时，字段必须带
"format": "file"或"format": "uri"，否则语言服务不认 - 别手写 schema —— schemastore.org 上已有
package.json、tsconfig.json等标准定义
没配 schema 的 JSON 字段，哪怕写成 "path": "./"，也不会弹路径建议。
补全默认省略扩展名（比如只显示 utils 而非 utils.ts），这是设计，不是 bug。现代模块解析器（Vite、Webpack、Node.js ESM）都支持后缀自动推导。真需要显式后缀，才去配 path-intellisense.extensionPaths。最常被忽略的其实是：VSCode 必须通过 File > Open Folder 打开整个项目，单文件打开会导致 ${workspaceFolder} 解析失败，所有映射失效。
