VSCode插件高效关键在于精准组合与配置咬合：ESLint+Prettier需通过eslint-config-prettier消除冲突并指定Prettier为默认格式器；Path Intellisense依赖jsconfig.json配置@路径映射；Debugger需正确设置sourceMaps和sourceMapPathOverrides；Live Server不支持history模式应改用Vite dev。

VSCode插件不是“装了就高效”，关键在于组合使用是否贴合真实开发链路。多数人装了一堆插件却没解决实际卡点，比如改个 v-model 还得手动补全 import、保存后样式错位、调试时找不到 source map 对应的源码行——这些问题背后，是插件没对齐工作流。

ESLint + Prettier 冲突导致格式化失效

常见现象：打开 .vue 文件，按 Ctrl+S 后代码没变化，或报错 ESLint: Delete `␍` prettier/prettier；更隐蔽的是，eslint --fix 和 prettier 互相覆盖规则，最终格式混乱。

• 根本原因是 ESLint 的 prettier 规则和 Prettier 插件同时启用，但未关闭 ESLint 中重复的格式类规则
• 必须在 .eslintrc.js 中显式引入 eslint-config-prettier，且放在 extends 数组末尾： extends: ['eslint:recommended', 'plugin:vue/vue3-recommended', 'prettier']
• VSCode 设置里禁用 editor.formatOnSave 对 ESLint 的触发（只留给 Prettier），并在 settings.json 中指定默认 formatter："editor.defaultFormatter": "esbenp.prettier-vscode"
• Vue 项目还需额外加 plugin:vue/recommended，否则 v-for key 检查等逻辑不会生效

Path Intellisense 配合 jsconfig.json 实现 @/ 路径自动补全

写 import Header from '@/components/Header.vue' 时，输入 @/ 后没提示、手敲路径易出错，本质是 VSCode 不知道 @ 指向哪里。

• 必须在项目根目录创建 jsconfig.json（TS 项目用 tsconfig.json），内容含 "baseUrl" 和 "paths"：
• { "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["src/*"] } } }
• Path Intellisense 插件本身不读取这些配置，需配合 VSCode 原生的 JavaScript 语言服务才能生效
• 如果用了 Vite，确保 resolve.alias 与 jsconfig.json 一致，否则跳转能用、补全失效

Debugger for Chrome 断点不命中，source map 映射失败

在 src/App.vue 打断点，刷新页面后断点变空心圆、控制台显示 Breakpoint ignored because generated code not found。

PigX UI 前端开发

PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。

下载

立即学习“前端免费学习笔记（深入）”；

• 核心问题是构建产物中 source map 路径与实际文件位置不匹配，尤其在 Vite 或 Webpack 多层嵌套输出时
• 在 .vscode/launch.json 中必须设置 "sourceMaps": true 和 "webRoot": "${workspaceFolder}"，Vite 项目还要加 "sourceMapPathOverrides"：
• "sourceMapPathOverrides": { "webpack:///src/*": "${webRoot}/src/*" }
• 确保构建命令开启 source map（Vite 默认开，Webpack 需检查 devtool: 'source-map'）
• Chrome 浏览器开发者工具中禁用 “Disable cache (while DevTools is open)” 以外的所有选项，避免缓存干扰映射

Live Server 与 Vue Router history 模式冲突导致 404

用 Live Server 启动 index.html，点击路由链接跳转后刷新页面，返回 Cannot GET /user 错误。

• Live Server 是静态服务器，不支持前端路由的 history fallback，它只认物理文件路径
• 临时解法：改用 hash 模式（createRouter({ history: createWebHashHistory() })）
• 长期方案：换用 Vite 自带的开发服务器（vite dev），或配置 Live Server 的 settings.json 加 "liveServer.settings.CustomBrowser": "chrome" 并配合 vue-router 的 scrollBehavior 降级处理
• 注意：Live Server 的端口配置项是 liveServer.settings.port，不是 port，写错会导致配置不生效

插件组合真正起效的临界点，往往卡在配置细节的咬合处——比如 jsconfig.json 少了个逗号，launch.json 的路径斜杠方向不对，甚至 prettier 版本和 eslint-config-prettier 不兼容。这些地方不报红，但整个链路就断了。