vscode插件需精准解决开发卡点而非堆砌:路径跳转失效需配置jsconfig.json/tsconfig.json的baseurl与paths并搭配vue官方扩展;eslint与prettier冲突应通过eslint-config-prettier关闭重叠规则;live server不适用于vue/vite项目,应改用框架自带命令;括号高亮已原生支持,旧插件应卸载;项目级.vscode/settings.json优先级高于全局设置。

VSCode 插件不是“装得越多越好”,而是要解决具体开发卡点:路径跳不进、格式一保存就乱、改个标签要手动同步闭合、热更新要反复刷新页面——这些才是真问题。
别名路径跳转失效?@/ 和 ~/ 点不开,本质是没配好解析规则
Vue 或 Webpack 项目里写 import { api } from '@/api/user',Ctrl+点击却提示“无法打开定义”,不是插件坏了,是 VSCode 不知道 @ 指向哪。
- 先确认项目根目录下有
jsconfig.json(JS)或tsconfig.json(TS),里面必须含"baseUrl": "src"和"paths"配置,例如:{ "compilerOptions": { "baseUrl": "src", "paths": { "@/*": ["*"] } } } - 再装插件
Path Intellisense或Alias Autocomplete,它们只补全、不跳转;真正实现跳转的是Vue VS Code Extension Pack(官方)或Vue Helper(第三方) - 如果用了 Vite,还需在
vite.config.ts中配置resolve.alias,否则插件可能读不到别名映射
eslint 和 prettier 冲突?不是谁该让步,而是得关掉重复规则
保存后代码缩进变两格、分号又没了、对象属性换行又乱了——这不是插件打架,是你没用 eslint-config-prettier 关掉 ESLint 里和 Prettier 重叠的格式化规则。
- 安装命令:
npm install --save-dev eslint-config-prettier - 在
.eslintrc.js的extends数组末尾加'eslint-config-prettier',顺序不能错 -
prettier只管格式,eslint只管逻辑和潜在错误;混淆这两者,就会出现 “修复后又报错” 的循环 - VSCode 设置里别同时开
editor.formatOnSave和eslint.autoFixOnSave(已废弃),改用eslint.codeActionsOnSave并指定"source.fixAll.eslint"
Live Server 启动不了或热更新失灵?关键看它是否监听了正确的文件类型
改完 .vue 文件,浏览器没刷新;或者启动时报 Cannot GET / ——多数情况不是端口被占,而是 Live Server 默认不处理单页应用(SPA)路由。
- 默认只响应
.html、.htm、.css、.js,对.vue、.ts、.jsx无感知 - 若用 Vue CLI 或 Vite 开发,直接用
npm run serve,别依赖 Live Server;它只适合纯静态 HTML/CSS/JS 原生开发 - 真要用 Live Server 处理 SPA,需在设置中加
"liveServer.settings.CustomBrowser": "chrome"和"liveServer.settings.AdvanceCustomBrowserCmdLine": ["--disable-web-security"](仅调试用) - 热更新失败常见于文件保存未触发“真正写入”,可关掉 VSCode 的
files.autoSave改为onFocusChange,避免编辑中途误触发
括号颜色混乱、嵌套太深看不清?bracket-pair-colorizer 已被原生替代
VSCode 1.68+ 版本起,editor.guides.bracketPairs 原生支持彩色括号匹配,老插件 Bracket Pair Colorizer 不仅冗余,还常与主题冲突导致高亮失效。
- 删掉旧插件,打开设置搜
bracket pair,启用Editor > Guides > Bracket Pairs - 如需更醒目,调高
editor.guides.highlightActiveBracketPair,光标所在括号对会加粗+背景色 - 对 JSX/TSX 深层嵌套,建议配合
indent-rainbow插件,用颜色区分缩进层级,比括号颜色更直观
插件配置最易被忽略的其实是“项目级覆盖”:全局设置再完美,也抵不过一个 .vscode/settings.json 里写了 "editor.formatOnSave": false。检查项目根目录下的 .vscode 文件夹,比翻全局设置更快定位问题。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











