Path Intellisense 插件可自动补全相对 / 绝对路径,支持 import、src、href 等上下文,启用后键入引号即提示;需开启主开关并检查语言模式、插件冲突及设置映射等细节。

VSCode 的 Path Intellisense 插件能自动补全相对路径和绝对路径,尤其在导入模块、引用图片、加载配置等场景下大幅提升效率。它默认监听 import、require、src、href、link 等常见属性,无需手动触发,键入引号后即弹出路径建议。
启用与基础配置
安装插件后一般自动生效。如未响应,检查是否被其他路径类插件(如 Auto Import)干扰。可在设置中搜索 path-intellisense,确认以下两项已开启:
- Path Intellisense: Enabled —— 主开关
- Path Intellisense: Show Hidden Files —— 如需补全以
.开头的文件(如.env)需勾选
支持的路径上下文
插件会智能识别多种常见路径写法,包括:
- ESM/CJS 模块导入:
import utils from "./utils/index.js" - HTML 属性:
<img src="./assets/logo.png" alt="VSCode 中的 Path Intellisense:自动补全文件路径 " > - CSS @import:
@import "./styles/variables.css"; - JSON 引用(部分语言模式下):
"main": "./dist/index.js"
不支持非字符串字面量路径(如拼接字符串 "./" + name),也不解析运行时变量。
自定义路径提示行为
可通过 settings.json 微调行为:
- 限制搜索深度:
"path-intellisense.extensionPaths": ["js", "ts", "json"]只提示指定后缀文件 - 排除目录:
"path-intellisense.excludedFiles": ["**/node_modules/**", "**/dist/**"] - 添加别名映射:
"path-intellisense.mappings": {"@": "${workspaceFolder}/src" },之后输入@/components/即可补全
常见问题处理
若补全不出现,先确认当前文件语言模式正确(如 .js 文件应为 JavaScript,而非 Plain Text)。有时重启 VSCode 或执行 Developer: Reload Window 可解决缓存问题。Windows 用户注意路径分隔符兼容性——插件默认输出 /,但会自动适配系统(也可在设置中强制使用 )。
基本上就这些。不复杂但容易忽略细节,开箱即用,适合绝大多数 前端 和 Node.js 项目。