VS Code 路径补全默认仅在 import/from、require()、HTML 的 src/href、CSS/SCSS 的 @import/url() 等上下文中触发，不支持模糊匹配或跨工作区跳转；需配置 editor.quickSuggestions.strings、jsconfig.json/tsconfig.json 的 baseUrl 和 paths，并重启 TS 服务。
VS Code 默认就能补全文件路径，但默认行为只在特定上下文生效（比如 import、require、src、href 等属性中），且不支持“模糊匹配”或跨工作区跳转。要真正好用，得手动调一下几个关键配置。
哪些地方会触发路径自动补全？
VS Code 的路径补全不是全局生效的，它依赖语言服务和语法上下文：
-
import/from后面（TypeScript/JavaScript） -
require()的字符串参数内 - HTML 中
src、href、link等属性值里 - CSS/SCSS 中
@import、url()内 - 不触发的典型场景：
console.log('./')、普通字符串赋值、JSON 文件里
如何让路径补全更智能？关键配置项
打开 VS Code 设置（Ctrl+, 或 Cmd+,），搜索并修改以下几项：
- 启用
"editor.quickSuggestions"→ 确保strings为true（否则字符串内不弹建议） - 关闭
"typescript.preferences.includePackageJsonAutoImports"（避免干扰路径补全） - 设置
"files.associations"正确映射后缀（比如把.vue关联到vue语言，否则src属性不识别） - 如需支持别名（
@/components/...），必须配jsconfig.json或tsconfig.json的"baseUrl"和"paths"
为什么写了 @/ 却不补全？别名配置要点
别名路径补全不是开箱即用的，VS Code 需要明确知道别名指向哪。以 Vue 项目为例：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"@assets/*": ["src/assets/*"]
}
},
"include": ["src/**/*.ts", "src/**/*.d.ts"]
}
注意：
- 必须保存
jsconfig.json或tsconfig.json到项目根目录 -
baseUrl设为"."才能让@/解析为相对./src/ - 改完配置后，重启 TS 服务：按
Ctrl+Shift+P→ 输入Restart TS server - 如果仍无效，检查当前文件是否被 TS 语言服务接管（右下角状态栏应显示
TypeScript，不是Plain Text）
路径补全失效的常见陷阱
很多问题其实和“补全功能本身”无关，而是环境或配置没对上：
- 工作区是多根文件夹（Multi-root Workspace）？路径补全默认只在当前根目录下生效，跨文件夹需额外配
"files.exclude"和"search.exclude"避免干扰 - 使用了 Vite +
resolve.alias但没同步写tsconfig.json？VS Code 不读 Vite 配置，只认 TS/JS 配置 - 开启了
"editor.suggest.snippetsPreventQuickSuggestions"且当前在代码片段中？会抑制路径建议 - 路径中含中文或空格？部分旧版本 VS Code 会跳过这类路径索引（升级到 1.85+ 基本修复）
路径补全看着简单，实际依赖语言服务、配置一致性、文件关联三者同时在线。最容易被忽略的是：改了 tsconfig.json 忘记重启 TS 服务，或者以为 Vite 别名能直接被编辑器识别——它不能。
