VSCode前端开发需配置Live Server、ESLint和Prettier三大核心:启用Live Server自动刷新需确保donotShowInfoMsg为false且端口未被占用;ESLint自动修复须用editor.codeActionsOnSave替代已弃用的autoFixOnSave;Prettier生效必须显式设置editor.defaultFormatter为esbenp.prettier-vscode,且所有配置应写入工作区.vscode/settings.json以保证环境一致。

VSCode 本身不是开箱即用的前端 IDE,装完不配就写 HTML/CSS/JS,很快会遇到保存不格式化、标签改了不自动同步、改完代码要手动刷新页面、ESLint 报错却不会自动修复等问题。核心问题不在插件多不多,而在几个关键点是否对齐:本地依赖有没有、插件行为有没有明确归属、格式化和校验有没有分清职责。
Live Server 启动后页面不自动刷新?检查 liveServer.settings.donotShowInfoMsg 和端口占用
常见现象是点击 Go Live 后浏览器打开页面,但后续保存 HTML 或 CSS 文件,页面毫无反应。这不是插件坏了,而是两个低级但高频的配置陷阱:
-
liveServer.settings.donotShowInfoMsg如果设为true,Live Server 会静默启动,不提示端口、路径等信息,你甚至不知道它有没有真跑起来;建议保持默认或显式设为false - 端口被占(比如之前没关干净的
npm run dev或另一个 VSCode 窗口),Live Server 默认尝试5500,失败后可能 fallback 到其他端口但不报错——此时浏览器地址栏还是旧端口,自然不刷新 - 确保 HTML 文件已保存(
Ctrl+S),Live Server 只监听已保存文件的变化,未保存的编辑内容不会触发重载
验证方式:右键菜单选 Open with Live Server 后,看右下角状态栏是否显示 Live Server: http://127.0.0.1:5500;如果没显示,说明根本没启动成功。
ESLint 报红但按 Ctrl+S 不修复?确认 eslint.autoFixOnSave 已禁用,改用 editor.codeActionsOnSave
VSCode 旧版设置里常用 eslint.autoFixOnSave,但它在 2024 年后已被标记为 deprecated。现在必须用新机制,否则 ESLint 检出的问题只会标红,不会自动修:
- 在工作区
.vscode/settings.json中,删除所有eslint.autoFixOnSave相关字段 - 添加如下配置:
{ "editor.codeActionsOnSave": { "source.fixAll.eslint": true }, "editor.formatOnSave": false } - 必须同时关掉
editor.formatOnSave,否则 Prettier 和 ESLint 会抢着格式化,导致样式反复横跳 - 确保项目根目录有本地安装的
eslint(npm install eslint --save-dev),VSCode 的 ESLint 插件默认不读全局版本
HTML 标签重命名失效?Auto Rename Tag 只作用于 .html 和 .htm 文件
你在 很多人装了 Prettier 插件,却始终没触发格式化,根源在于 VSCode 不知道该让谁来干这事。它不会自动把 Prettier 设为默认格式化器: 最易被忽略的一点:所有这些配置(Live Server 端口、ESLint 修复开关、Prettier 默认格式化器)都优先读取工作区 .vue 或 .jsx 里改
.vue 文件无效(需配合 Volar 或 Vetur).jsx / .tsx 也无效(React 场景下建议用 ESLint 的 react/jsx-tag-spacing 规则约束)settings.json 加:"auto-rename-tag.activationOnLanguage": ["html", "xml", "php", "javascriptreact"]
,但注意 javascriptreact 仅限 JSX 开头的标签,不处理 JS 内部字符串里的 HTML 片段Prettier 保存时没生效?检查
editor.defaultFormatter 是否指向 esbenp.prettier-vscode
settings.json,确认有这一行:"editor.defaultFormatter": "esbenp.prettier-vscode"
.prettierrc 或 package.json 里的 prettier 字段,Prettier 插件会自动读取;没有的话它就用内置默认规则(比如单引号、不加分号)source.fixAll.eslint),而你又没配 eslint-config-prettier,就会出现保存时 ESLint 把双引号改成单引号,Prettier 又立刻改回去的“抖动”.vscode/settings.json,而不是用户全局设置。多人协作时,务必把它们放进项目里,否则换台电脑或拉新分支,环境就断了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











