新手真正该优先配的只有5个插件:live server、prettier、eslint、vue vscode extension pack(或对应框架包)、vscode-icons;其他如ai助手、自动重命名类插件易干扰语法直觉,建议暂缓安装。

装太多插件反而拖慢编辑器、掩盖基础问题,新手真正该优先配的只有 5 个:Live Server、Prettier、ESLint、Vue VSCode Extension Pack(或对应框架包)、vscode-icons。其他所谓“AI助手”“自动重命名”类插件,实测会干扰语法直觉,先别碰。
Live Server 启动后浏览器不自动打开?检查端口和协议
点击状态栏 Go Live 按钮后没反应,常见原因不是插件坏了,而是端口被占或协议不匹配:
- 默认端口
5500被其他服务占用时,VSCode 不会报错,只会静默失败;可在设置中搜liveServer.settings.port改为0(随机端口)或指定空闲端口如8080 - 如果项目含
index.html但路径不在根目录(比如在src/下),Live Server 默认只扫描工作区根目录,需右键该文件再点Open with Live Server - 某些安全软件会拦截
http://127.0.0.1:xxx请求,可临时禁用或改用localhost—— 在设置里开liveServer.settings.AdvanceCustomBrowserCmdLine,填["--unsafely-treat-insecure-origin-as-secure=http://localhost:5500", "--user-data-dir=/tmp/chrome"](仅限调试)
Prettier 和 ESLint 冲突导致保存后代码乱跳?关掉重复规则
两者都管格式,硬叠一起会互相覆盖,典型表现是保存后引号变双又变单、分号忽有忽无:
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。
- 必须安装
eslint-config-prettier并在.eslintrc.js的extends末尾加上它,顺序不能错:['airbnb', 'prettier']✅,['prettier', 'airbnb']❌ - VSCode 设置里关掉
editor.formatOnSave,只留editor.codeActionsOnSave中的"source.fixAll.eslint",让 ESLint 统一接管格式+校验 - 若项目用 Vue,
vue-eslint-parser版本要 ≥ 9.0,否则<template></template>块内 JS 表达式会被误判为错误
Vue 文件里 template 标签不识别、无补全?确认扩展包已激活且无冲突
装了 Vue 相关插件却没高亮、没属性提示,大概率是扩展加载顺序或语言模式错了:
- 必须装官方
Vue VSCode Extension Pack(含Vue Language Features+Volar),别用已停更的Vetur;Volar 是 Vue 3 官方推荐,Vetur 对<script setup></script>支持差 - 打开任意
.vue文件后,看右下角状态栏语言模式是否为Vue,不是就点它手动切;如果点了还是变回HTML,说明files.associations被其他插件覆盖,在settings.json加:"*.vue": "vue" - 若仍无响应,禁用所有非必要插件(尤其旧版 Vue Helper、Auto Rename Tag),重启 VSCode 后逐个启用排查
文件图标全是白色文档?vscode-icons 需手动启用主题
插件装完图标没变,不是失效,是 VSCode 默认没切换图标主题:
- 按
Ctrl+,打开设置,搜icons theme,下拉选VSCode Icons,不要选None或系统默认 - macOS 用户若想适配原生风格,额外装
vscode-icons-mac,但注意它和主插件不兼容,装了就得卸载原版 - 图标不显示也可能因文件夹被设为“排除项”,检查
files.exclude设置里有没有误加了**/*.vue这类通配
最常被忽略的其实是工作区设置优先级:用户级设置(全局)会被工作区级(项目根目录 .vscode/settings.json)覆盖,而后者又可能被 .prettierrc 或 .eslintrc.js 覆盖。调一个插件效果前,先确认你在哪一层改的配置。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










