0

0

怎样在VSCode中配置Vue.js项目开发与热重载【教程】

狼影

狼影

发布时间:2026-01-22 08:35:17

|

715人浏览过

|

来源于php中文网

原创

VSCode中Vue项目热重载不生效需先确认使用Vite或Vue CLI,检查开发服务器是否运行、端口是否被占、files.autoSave设置、插件是否为Volar(Vue3)或Vetur(Vue2),并验证vite.config.ts中HMR配置及sourcemap路径映射。

VSCode 里 Vue 项目热重载不生效?先确认你用的是 Vite 还是 Vue CLI

热重载行为和配置方式完全不同:vue cli 用 vue-cli-service servevitevitenpm run devvscode 本身不提供热重载,它只是编辑器;真正起作用的是底层开发服务器。如果你改了 .vue 文件但浏览器没更新,大概率是服务没跑起来,或者端口被占、https 配置干扰、甚至文件保存没触发(比如禁用了 vscode 的 files.autosave)。

实操建议:

  • 终端里手动运行 npm run dev(Vite)或 npm run serve(Vue CLI),别只靠插件按钮
  • 检查终端输出是否看到 Local: http://localhost:5173/(Vite)或 App running at:(Vue CLI)
  • 打开浏览器访问对应地址,而不是直接双击 index.html
  • 确认 VSCode 设置里 files.autoSaveonFocusChangeafterDelay,避免“改了没保存”假象

必须装的 VSCode 插件只有两个:Volar 和 TypeScript Vue Plugin

Vue 3 + `

实操建议:

  • 安装 Volar(作者:johnsoncodehk),启用它
  • 再装 TypeScript Vue Plugin (Volar)(同一作者),这是让 .vue 文件内 获得 TS 类型检查的关键
  • 如果项目用的是 Vue 2,别硬套 Volar;改用 Vetur,并确保 vetur.experimental.templateInterpolationService 设为 true
  • 重启 VSCode,否则 Volar 的语言服务器不会加载

热重载失效常见原因:HMR 配置被覆盖或监听路径不对

Vite 默认开启 HMR,但某些场景下会静默失败:比如你在 vite.config.ts 里写了 server.watch.ignored 却误加了 **/*.vue;或者用了 alias 指向了 symlink 目录,而系统未开启 server.watch.usePolling;又或者你在 WSL 中开发却没配 server.host: '0.0.0.0',导致 Windows 端浏览器无法连接。

立即学习前端免费学习笔记(深入)”;

CoCo
CoCo

智谱AI推出的首个有记忆的企业自主Agent智能体

下载

实操建议:

  • 检查 vite.config.ts 中是否意外设置了 hmr: falseserver.watch.ignored 包含 vue 文件
  • WSL 用户加一行:server: { host: '0.0.0.0', port: 5173 },并在 Windows 浏览器访问 http://localhost:5173
  • 若使用 NFS 或 Docker 挂载,加上 server.watch.usePolling = true(性能略降,但稳定)
  • 修改 src/App.vue 试试,排除是某个子组件因 defineComponent 写法或 setup() 返回值问题导致局部 HMR 失效

调试 Vue 组件时断点不命中?检查 VSCode 的 launch.json 配置

VSCode 调试依赖 .vscode/launch.json 启动 Chrome 并注入 sourcemap。如果点了调试按钮却没反应,或断点灰掉,通常是路径映射(sourceMapswebRoot)没对上。

实操建议:

  • 生成标准配置:在调试面板点「创建 launch.json」→「Chrome」→ 选中 “vuejs: chrome” 模板(Volar 提供)
  • 确认 webRoot 指向项目根目录,例如 "${workspaceFolder}",不是 "${workspaceFolder}/src"
  • 确保 vite.config.tsbuild.sourcemaptrue(开发模式默认开启,但显式写出来更安心)
  • 启动调试前,先确保开发服务器已运行;VSCode 调试器不会自动拉起 vite
热重载本身很轻量,但一旦混入别名、符号链接、WSL、Docker、自定义构建脚本这些环节,链路就容易断在某个隐式环节。最有效的排查方式永远是:看终端日志有没有 HMR updated,浏览器控制台有没有 [vite] hot updated:,以及 Network 面板里有没有 hot-update.json 请求成功。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

416

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

533

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

310

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

75

2025.09.10

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

794

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

735

2023.11.06

html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

616

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

656

2023.06.21

AO3中文版入口地址大全
AO3中文版入口地址大全

本专题整合了AO3中文版入口地址大全,阅读专题下面的的文章了解更多详细内容。

1

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 6.9万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 1.4万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号