VSCode编译Vue为什么极其缓慢_VSCode排除node_modules【排错】

冬宇君_8057

冬宇君_8057

2026-06-05

1055人浏览

原创

vscode vue开发卡顿的根源是volar与ts服务冲突及node_modules反复扫描,解决需配置watcherexclude、禁用内置ts服务并收紧tsconfig。

vscode编译vue为什么极其缓慢_vscode排除node_modules【排错】

VSCode 本身不编译 Vue 代码——卡在“编译缓慢”其实是语言服务、文件监视和扩展叠加阻塞的结果,核心矛盾是 node_modules 被反复扫描 + Volar 与内置 TS 服务冲突。

为什么 Vue 文件打开/保存/补全都慢,甚至要 reload window?

这不是 Vue 编译器(Vite / Vue CLI)慢,而是 VSCode 的语言支持层在反复做三件事:Volar 启动时加载整个 node_modules 下的类型声明、TypeScript Server 同时也在扫描相同路径、files.watcher 对 node_modules 里数万个小文件持续发变更事件。三者一叠加,CPU 占满,编辑器就“冻住”。

常见现象包括:

  • 输入 ref( 后等 2–3 秒才弹出提示
  • 保存 .vue 文件后,错误红线延迟出现或根本不出现
  • 点击跳转定义(F12)卡顿,甚至跳到 node_modules/vue 源码里出不来
  • 终端里 npm run dev 启动快,但 VSCode 自带终端输入命令也延迟

必须在工作区级配置 files.watcherExclude

全局设置无效,且容易误伤其他项目。只对当前 Vue 项目生效的写法是:

"files.watcherExclude": {
  "**/node_modules/**": true,
  "**/dist/**": true,
  "**/build/**": true,
  "**/.git/**": true,
  "**/__pycache__/**": true,
  "**/logs/**": true
}

注意:

  • 路径必须用双星号 **/,不是 node_modules/ —— 否则子目录仍被监听
  • 改完后必须关闭并重新打开该工作区(不是 reload window),否则不生效
  • 如果你用 pnpm,额外加 "**/node_modules/.pnpm/**": true,它内部嵌套更深
  • Windows + WSL2 用户,务必再加 "**/mnt/**": true,跨系统路径监听会引发严重延迟

禁用内置 TS 服务,强制 Volar Takeover 模式

VSCode 默认同时启用 TypeScript and JavaScript Language Features(@builtin)和 Volar,两者对同一份 .vue 和 .ts 文件争抢控制权,导致 AST 解析重复、内存暴涨、补全错乱。

vue-component-analyzer
vue-component-analyzer

递归分析 Vue 项目组件依赖,从入口文件生成组件层级图,支持 Vue 2/3,输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载

操作步骤:

  • 按 Ctrl+Shift+P → 输入 built → 选中 Extensions: Show Built-in Extensions
  • 搜索 typescript(保留 @builtin 前缀)→ 找到 TypeScript and JavaScript Language Features
  • 点击右下角齿轮 → Disable (Workspace)
  • 重启窗口(Developer: Reload Window)

验证是否生效:打开一个 .vue 文件,状态栏右下角应显示 Volar,而不是 TypeScript 或 Vue。

Volar 启动仍慢?检查 types 引入路径

即使开了 Takeover,如果 tsconfig.json 里写了宽泛的 "include": ["**/*"] 或引用了 node_modules/@types/xxxx 中体积巨大的类型包(如 @types/node + @types/react 混用),Volar 初始化时仍会同步解析所有内容。

建议收紧:

  • 把 tsconfig.json 的 include 改为明确路径:"include": ["src/**/*", "types/**/*"]
  • 移除没用到的 types 字段,比如 "types": ["vite/client", "vue/macros"] 就够,别加 "node"
  • 确认 volar.config.json(如有)没开启 "experimental.enableTsPlugin" 这类高开销实验功能

最后提醒一句:禁用 ESLint 扩展的全局校验、关掉 Prettier 的 formatOnSave、卸载 Auto Import —— 这些扩展在 Vue 大项目里,比你想象中更早开始拖后腿。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode vue typescript node

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1275

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2672

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1909

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1727

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2587

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1818

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1242

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1116

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

474

5

热门下载

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

精品课程

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