vue项目@/路径无法跳转的根本原因是vscode未识别别名,必须在项目根目录配置jsconfig.json(js)或tsconfig.json(ts),含baseurl和paths,如{"compileroptions":{"baseurl":".","paths":{"@/":["src/"]}}},且需重启vscode生效。

Vue 或 React 项目里装了一堆插件却越配越卡、跳转失效、保存就报错——问题不在插件多,而在没理清谁该管什么、谁该听谁的。
Vue 项目中 @/ 路径无法 Ctrl+点击跳转?
不是插件没装,是 VSCode 根本不知道 @/ 指向哪。Path Intellisense、Vue Helper 这类插件只负责“执行跳转”,不负责“定义路径”。
- 必须在项目根目录有
jsconfig.json(JS)或tsconfig.json(TS),且含baseUrl和paths配置,例如:{"compilerOptions": {"baseUrl": "src", "paths": {"@/*": ["*"]}}} - Vite 项目还需同步配置
vite.config.ts中的resolve.alias,否则运行时正常、编辑器跳转仍失败 - 改完配置必须重启 VSCode,否则不会重载
jsconfig.json - 别用 Path Intellisense 当跳转主力——它只补全,不解析别名;真正支持跳转的是
Vue VS Code Extension Pack(官方)或Vue Helper
ESLint 和 Prettier 保存后反复修改代码?
根本不是规则冲突,是 VSCode 让两个插件同时抢 editor.formatOnSave 的控制权。Prettier 管格式,ESLint 管逻辑,但默认都试图格式化。
- 在
.vscode/settings.json中明确指定:"editor.defaultFormatter": "esbenp.prettier-vscode",并设"eslint.format.enable": false -
.eslintrc.js的extends数组末尾加"eslint-config-prettier",它会关掉 ESLint 所有格式类规则(如semi、quotes) - 别同时启用
eslint-plugin-prettier和eslint-config-prettier——前者把 Prettier 当 ESLint 规则跑,后者才是清道夫;二者混用反而增加执行链路 - 项目根目录必须有
.prettierrc,不能只靠 VSCode 设置;否则团队成员格式不一致
Live Server 启动后改 .vue 文件不刷新?
Live Server 本质是个静态文件服务器,不理解 Vue 单文件组件、不走打包流程、也不支持路由 fallback。它只监听 .html、.css、.js 变更。
- Vue/Vite/React 项目一律用框架命令启动:
npm run dev、npm run serve,别依赖 Live Server - 如果硬要用 Live Server 原型演示,右键
index.html→ “Open with Live Server”,而不是点状态栏 Go Live 按钮——后者以工作区根为服务根,常导致路径错乱 - Live Server 不支持原生 ESM 模块(
import报Failed to resolve module specifier),遇到就换npx serve或vite preview - 端口冲突静默失败很常见,启动前先执行
netstat -ano | findstr :5500(Windows)或lsof -i :5500(macOS/Linux)查杀占端进程
最易被忽略的一点:所有配置(jsconfig.json、.eslintrc.js、.prettierrc)必须放在项目根目录,且 VSCode 必须以该目录为工作区打开——子目录打开时,插件读不到上层配置,跳转、校验、格式化全失效。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











