path intellisense 插件生效需开启两个开关：path intellisense: enabled（主控开关）和 path intellisense: auto surround（决定是否自动触发补全）；别名路径补全还需满足三条件：项目含正确配置的 tsconfig.json/jsconfig.json、path-intellisense.mappings 为空或与之严格一致、重启 ts server。
Path Intellisense 插件必须开启的两个开关
装完插件不生效，大概率是主开关没开。VSCode 不会默认启用它，哪怕你刚点完 Install。打开设置（Ctrl+,），搜 path-intellisense，确认以下两项已勾选：
-
Path Intellisense: Enabled—— 主控开关，关了就彻底没反应 -
Path Intellisense: Auto Surround—— 决定是否在输入"或'后立刻弹建议；不勾选的话，得手动按Ctrl+Space才触发
别名路径（如 @/utils）补不全？这两个开关只是前提，不是全部。
别名路径补全失败的三个硬性条件
VSCode 和 Path Intellisense 都不会“猜”别名指向哪，它们只读配置。缺一不可：
- 项目根目录存在
tsconfig.json或jsconfig.json，且含"baseUrl"和"paths"（例如"@/*": ["src/*"]） -
path-intellisense.mappings设置为空（推荐）或与 tsconfig 严格一致；填错或留空但没配 tsconfig，都不行 - 执行命令面板里的
Developer: Restart TS Server—— 否则旧缓存还在，改了配置也白搭
Windows 用户注意：paths 中的路径分隔符用 /，插件会自动适配系统，别写成 \。
JSON 文件里路径字段没提示？不是插件问题，是语义缺失
VSCode 默认把 JSON 当纯文本处理，"main": "" 这种字段根本不会被识别为路径上下文。要让它生效，得靠 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": "./"，也不会弹路径建议。
路径补全显示文件但不带扩展名？这是设计，不是 bug
VSCode 和 Path Intellisense 默认省略扩展名（补全 utils 而非 utils.ts），因为现代模块解析器（Node.js、Vite、Webpack）都支持自动后缀推导。如果你确实需要显式写出后缀：
- 设置
path-intellisense.extensionPaths为数组，例如["ts", "js", "jsx", "tsx"] - 扩展名必须全小写，且不能带点（
"ts"✅，".ts"❌） - 这个设置只影响补全列表内容，不影响实际解析行为
补全行为高度依赖当前光标所在语法位置——import 里和 console.log() 里，连触发逻辑都不同，别指望一个设置全局生效。
