Path Intellisense 路径补全失效主因是配置未启用、语言模式错误、插件冲突或别名未映射；需检查 path-intellisense.enabled、showHiddenFiles、jsconfig/tsconfig 别名配置及 search.include/exclude 范围。
Path Intellisense 插件不补全路径的常见原因
插件装了但敲 src=" 或 import 后没提示，大概率不是插件坏了，而是几个关键开关没开或被干扰。
-
path-intellisense.enabled必须设为true（默认开启，但可能被其他插件覆盖） - 检查是否启用了
path-intellisense.showHiddenFiles——如果要补全.env或.gitignore这类文件，必须手动打开 - 确认当前文件的语言模式正确：比如
.vue文件需启用vue模式，否则src属性可能不被识别为路径上下文 - 排查插件冲突：
Auto Import、Import Sorter等插件有时会劫持引号触发逻辑，可临时禁用测试
让 VSCode 识别 @/ 别名的两种可靠方式
只装 Path Intellisense 不足以支持 @/components/Button.vue 的跳转和补全，必须配合项目级或编辑器级映射配置。
- 项目级（推荐）：在根目录加
jsconfig.json或tsconfig.json，写入：{ "compilerOptions": { "baseUrl": "./", "paths": { "@/*": ["src/*"] } }, "exclude": ["node_modules"] }——这是 TypeScript/JavaScript 语言服务真正理解别名的依据 - VSCode 级：在用户或工作区
settings.json中加："path-intellisense.mappings": { "@": "${workspaceFolder}/src" }——仅影响补全和预览，不参与类型检查或跳转 - 注意：两者可共存，但跳转功能依赖
jsconfig.json；若只配了 mapping，Ctrl+点击@/会失败
search.include 和 search.exclude 控制路径识别范围
全局搜索（Ctrl+Shift+F）时路径识别不准，往往是因为 VSCode 默认扫描整个工作区，而你只想查 src 下的模块引用。这时候得靠搜索配置精准收口。
-
search.include是白名单：只扫描列出的路径，例如"${workspaceFolder}/src/**"，未列出的目录（如docs/或mock/）完全不进搜索范围 -
search.exclude是黑名单：常用于屏蔽node_modules/**、dist/**、.git/**，避免噪音干扰 - 路径变量必须用
${workspaceFolder}，不能用./或绝对路径——后者在多根工作区下会失效 - 配置放在工作区
.vscode/settings.json中才生效，用户级设置对搜索范围无影响
路径补全失效时该看哪几个地方
补全突然停摆，别急着重装插件。先快速验证这三处：
- 当前文件是否保存？Path Intellisense 对未保存的临时文件（
Untitled-1）不工作 - 光标是否在字符串内？它只响应引号内的路径，
require("./utils" + ".js")这种拼接式写法永远不补全 - 插件是否加载成功？按
Ctrl+Shift+P输入Developer: Show Running Extensions，找christian-kohler.path-intellisense看状态栏是否显示“已激活” - 路径本身是否合法？比如输入
./nonexistent/后按 Ctrl+Space，若目录不存在，插件不会报错也不会提示，而是静默跳过
路径映射和补全逻辑本身不复杂，但容易卡在配置层级错位或上下文识别偏差上——尤其是多根工作区、混用 jsconfig/tsconfig、以及插件版本升级后默认行为变化这几个点，最容易漏查。
