VSCode中Node.js原生文件系统监听器（fs.watch）在大项目下的优化方案-VSCode-PHP中文网

必须在项目根目录.vscode/settings.json中配置"files.watcherexclude": {"/node_modules/": true, "/dist/": true, "/.git/": true}，并调高linux/macos系统inotify限制至524288，否则fs.watch因句柄耗尽导致文件变更不响应、保存延迟。

vscode中node.js原生文件系统监听器（fs.watch）在大项目下的优化方案

为什么fs.watch在VS Code里会拖垮大项目

VS Code底层大量依赖 Node.js 的 fs.watch（Linux/macOS 下实际走 inotify/fsevents，Windows 用 ReadDirectoryChangesW），但它不是“智能监听”——每个被监视的路径都会占用一个系统级 watcher 句柄。一旦项目含 node_modules、dist、.git/objects 这类目录，句柄数轻松突破 Linux 默认的 fs.inotify.max_user_watches=8192，直接触发 ENOSPC 错误，导致文件变更不响应、Git 状态卡死、保存延迟。

files.watcherExclude 必须这样写才生效

files.watcherExclude 不是通配符过滤器，而是 glob 匹配规则，写错就等于没配：

**/node_modules/** ✅ 有效 —— 开头必须是 **/，结尾加 /** 才能递归排除子目录
node_modules/** ❌ 无效 —— 缺少 **/ 前缀，VS Code 根本不识别
**/dist ❌ 不完整 —— 不匹配 dist/index.html，必须写成 **/dist/**
Monorepo 项目要额外加 **/packages/**/node_modules/**，否则子包的依赖仍被监听

配置位置必须是工作区级的 .vscode/settings.json，用户级设置会被覆盖，且不生效于当前项目。

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

Linux/macOS 下 inotify 句柄不够怎么办

即使配了 files.watcherExclude，如果系统限制太低，VS Code 启动时仍可能 fallback 到轮询（CPU 暴涨），这时得调系统参数：

临时生效（重启失效）：echo 524288 | sudo tee /proc/sys/fs/inotify/max_user_watches
永久生效：echo 'fs.inotify.max_user_watches=524288' | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
验证是否生效：cat /proc/sys/fs/inotify/max_user_watches 输出应为 524288
macOS 用户若仍卡顿，可尝试禁用硬件加速："window.titleBarStyle": "native" + 启动时加 --disable-gpu 参数

别让扩展偷偷绕过你的排除规则

很多扩展（比如 Auto Rename Tag、某些 ESLint 配置、Path Intellisense）内部自己调用 fs.watch 或递归扫描，完全无视 files.watcherExclude。它们才是真正的“监听 rogue process”：

打开命令面板，运行 Developer: Show Running Extensions，看哪些扩展在后台持续占用 CPU
重点排查 Activation Events 含 onStartup 或 * 的扩展，右键选择 Disable (Workspace)
GitLens 可保留，但建议设 gitlens.advanced.fileWatcher.latency 为 1000，降低监听频率
ESLint 若配置了 validate: ["javascript", "typescript"] 全局扫描，会强制监听整个工作区 —— 改为只监听 src/**/*.{js,ts}