配置路径别名需两步:1. 在tsconfig.json中设置baseUrl和paths,使VSCode识别@/等别名;2. 在构建工具(如Vite、Webpack)中配置相同alias,确保运行时解析。完成后即可使用import Button from '@/components/Button.vue',实现编辑器智能提示与项目正常运行。

在 VSCode 中配置路径别名,主要是为了让代码中的导入路径更简洁,比如用 @/components 代替 ../../components。要实现这一点,需要两步:一是让项目支持别名(如通过构建工具),二是让 VSCode 能识别这些别名,避免报错和获得正确的跳转提示。
1. 配置 tsconfig.json 或 jsconfig.json
这是关键一步。VSCode 会根据项目根目录下的 tsconfig.json(TypeScript)或 jsconfig.json(JavaScript)文件解析路径别名。
在项目根目录创建或修改该文件,添加 baseUrl 和 paths 配置:
{ "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"], "@components/*": ["src/components/*"], "@utils/*": ["src/utils/*"] } } }说明:
- baseUrl: "." 表示相对路径从项目根开始
- "@/*": ["src/*"] 表示所有以 @/ 开头的导入,都会指向 src 目录下对应路径
保存后,VSCode 会自动读取这个配置,红色波浪线消失,且能正常跳转到别名路径的文件。
2. 让构建工具支持别名
VSCode 只负责编辑器层面的识别。实际运行时,还需要构建工具理解这些别名。
常见框架配置方式:
- Vite:在 vite.config.js 中配置 resolve.alias
- Webpack:在 resolve.alias 中添加相同别名
- Next.js:在 next.config.js 中配置 webpack.resolve.alias
例如 Vite 配置:
// vite.config.js export default { resolve: { alias: { '@': '/src', '@components': '/src/components' } } }3. 使用别名导入
配置完成后,就可以在代码中使用:
import Button from '@/components/Button.vue'; import { api } from '@utils/request';VSCode 不仅不会报错,还能点击跳转、自动补全。
基本上就这些。核心是 tsconfig.json/jsconfig.json 的 paths 配置,配合构建工具同步设置,就能在编辑器和运行时都正常使用路径别名。不复杂但容易忽略。










