path intellisense不补全相对路径主因是未配置mappings；需在.vscode/settings.json中显式声明"@": "${workspacefolder}/src"等映射，禁用autoguess、排除node_modules，并确保语言模式正确。
Path Intellisense 插件装了但不补全相对路径？检查 path-intellisense.mappings 配置
插件默认只识别标准相对路径（如 ./utils/helper.ts），遇到 @/components/Button.vue 或 #lib/utils 这类别名路径时直接失效。根本原因不是插件坏了，而是它压根没被告知这些前缀对应哪段真实路径。
解决方法是在工作区 .vscode/settings.json 中显式声明映射关系：
{
"path-intellisense.mappings": {
"@": "${workspaceFolder}/src",
"#lib": "${workspaceFolder}/lib"
}
}
-
${workspaceFolder}是必须的——硬写绝对路径会导致换机器或克隆仓库后失效 - 如果项目用 Vite +
resolve.alias，确保这里的键名（如@）和vite.config.ts里alias的find字段完全一致（包括末尾斜杠） - 重启 VSCode 窗口才能让新配置生效，仅重载窗口不够
TypeScript 项目中 import 补全错乱？关掉 typescript.preferences.includePackageJsonAutoImports
VSCode 内置 TS 语言服务会主动往 import 语句里塞 node_modules 包路径，和 Path Intellisense 的路径补全打架。典型表现是：输入 import { 后弹出一堆 node_modules/xxx/index.d.ts 的选项，而你真正想补全的 ./api/user 根本不出现。
临时禁用这个干扰项即可：
"typescript.preferences.includePackageJsonAutoImports": "off"
- 该设置不影响类型检查，只停掉自动插入包路径的行为
- 如果你依赖
package.json的exports字段做模块解析，且用了自定义baseUrl，还得同步配好jsconfig.json或tsconfig.json的compilerOptions.baseUrl
补全时显示 Cannot find module 'xxx' 错误？检查 files.associations 是否覆盖了文件类型
Vue、Svelte 或 Astro 文件里写 import 时路径补全失效，控制台报 Cannot find module，大概率是 VSCode 把这些文件当成了纯 HTML 处理。Path Intellisense 默认只在 javascript、typescript、vue 等已知语言模式下激活。
确认当前文件右下角语言模式是否正确（比如 .vue 文件应显示 Vue 而非 HTML）。若不对，在 .vscode/settings.json 加上：
"files.associations": {
"*.vue": "vue",
"*.svelte": "svelte"
}
- 别漏掉引号——
*.vue必须是字符串，写成*.vue: vue会解析失败 - 某些旧版 Vue 插件会覆盖语言模式，此时需在 VSCode 设置里搜
vue.autoInsert关掉冲突功能
为什么 path-intellisense.autoGuess 开启后反而更慢？它会触发全盘扫描
autoGuess 设为 true 时，插件会在你输入 ./ 后遍历整个工作区找匹配文件。小项目无感，但一旦 node_modules 没被忽略，或项目含大量构建产物（dist/、.next/），补全延迟可达 2–3 秒，甚至卡住编辑器。
更稳的做法是关掉自动猜测，改用精准配置：
- 删掉
"path-intellisense.autoGuess": true - 用
"path-intellisense.excludedItems"显式排除干扰目录："path-intellisense.excludedItems": { "**/node_modules/**": true, "**/dist/**": true, "**/.git/**": true } - 如果项目结构固定（如所有组件都在
src/components/），直接配mappings比瞎猜靠谱得多
别指望一个插件解决所有路径问题——别名解析靠配置，类型提示靠 TS 配置，补全响应速度靠排除无关目录。三者漏一，路径补全就容易卡在半路。
