vue 3 项目必须装 volar 并禁用 vetur,二者不可共存;volar 提供 setup 语法识别、ref 类型推导和模板属性补全,vetur 会导致这些功能全部失效。

VS Code 本身不带前端开发能力,所有关键功能(语法提示、格式化、调试、接口测试)都依赖插件,装错、漏装或版本冲突会直接卡住项目启动。
哪些插件必须装,且不能共存
Vue 3 项目里 Volar 和 Vetur 冲突,装了 Vetur 会导致 setup 语法无法识别、ref 类型推导失败、模板中属性无补全——这是新手最常踩的坑,不是配置问题,是插件打架。
-
Volar是 Vue 官方维护的 Vue 3 语言支持,必须启用 -
Vetur是 Vue 2 时代的旧插件,必须禁用(右键 → Disable Workspace Extension) -
ESLint和Prettier要一起装,但需在.eslintrc.cjs中明确关闭 Prettier 规则,否则保存时反复格式化 -
REST Client直接在.http文件里发请求,比浏览器手动输接口快得多,尤其适合联调阶段反复测十几个端点
安装后必须重启 VS Code 才生效
很多插件(尤其是 Volar、ESLint)注册的是语言服务器,只在启动时加载一次。改完设置或装完插件后点“Reload Window”比关掉再开更快,但别跳过这步——否则你会看到“No ESLint configuration found”这种报错,其实配置早就写好了。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度,帮助开发者将普通页面升级为高品质产品级界面。
- 快捷键:
Ctrl+Shift+P→ 输入Developer: Reload Window - 中文插件装完也得重启,否则界面还是英文(右下角提示“Change Language and Restart”不能忽略)
- 如果插件列表里显示“Enable”但灰着,说明它被其他插件禁用了,点右侧三个点 → “Enable for Workspace”
code 命令没加进 PATH 就没法从终端直接打开项目
Windows 用户装 VS Code 时没勾选“Add to PATH”,Mac 用户没运行 Shell Command: Install 'code' command in PATH,会导致你在终端 cd 进项目后输 code . 报错“command not found”。这不是插件问题,是编辑器自身命令链断了。
- Windows:重装 VS Code,安装向导里务必勾选“Add to PATH”
- macOS:打开 VS Code →
Cmd+Shift+P→ 搜shell command→ 点击对应选项 - Linux:执行
code --install-extension ms-vscode.vscode-typescript-next这类命令前,先确认code可执行
插件装完只是起点,真正卡住人的往往是 Volar 的 TypeScript 版本兼容性、ESLint 配置和 Prettier 的优先级顺序、或者 REST Client 里 Cookie 没自动带过去——这些细节不会报红叉,但会让开发节奏慢一半。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










