VSCode在Linux报ENOSPC、Failed to watch或卡在Loading...，根本原因是fs.inotify.max_user_watches耗尽；需先用cat /proc/sys/fs/inotify/max_user_watches确认上限（≤16384即不足），再执行sudo sysctl -w fs.inotify.max_user_watches=524288临时提升并彻底重启VSCode验证，最后通过sudo tee /etc/sysctl.d/99-vscode-inotify.conf && sudo sysctl --system永久生效，同时配合files.watcherExclude排除node_modules等目录以治本。
VSCode 在 Linux 上报 ENOSPC、Failed to watch 或卡在 Loading...，基本就是 fs.inotify.max_user_watches 打满了，不是插件或项目配置的问题，直接调这个内核参数就行。
怎么确认真是 inotify 资源耗尽
别猜，先查实际值和用量：
- 当前上限：
cat /proc/sys/fs/inotify/max_user_watches—— 若 ≤ 16384，大概率是它 - 已用数量（粗略）：
find /proc/*/fd -lname anon_inode:inotify -print 2>/dev/null | wc -l - 同时检查其他相关限制：
cat /proc/sys/fs/inotify/max_user_instances和cat /proc/sys/fs/inotify/max_queued_events，但绝大多数情况瓶颈在max_user_watches - 典型现象：打开含
node_modules的前端项目后，左下角弹Failed to watch workspace；保存文件不触发 ESLint/Prettier；code --status显示大量watcher::create失败
临时提升 max_user_watches（验证用）
一行命令立即生效，适合快速验证是否根因：
- 执行：
sudo sysctl -w fs.inotify.max_user_watches=524288 - 验证是否写入：
sysctl fs.inotify.max_user_watches应输出524288 - 必须完全退出 VSCode（macOS 要退出菜单栏图标，Linux 要杀掉所有
code进程），再重新启动 ——Developer: Reload Window不起作用 - 注意：该值重启系统后还原；设太高（如 200 万）会导致每个 watch 占约 1KB 内核内存，524288 ≈ 512MB，已足够覆盖绝大多数项目
永久生效的两种写法，选对才真正持久
不同发行版加载机制不同，写错路径或命令就白配：
- 推荐方式（兼容 Ubuntu 22.04+、Rocky 9、Debian 12 等）：
创建独立配置：echo "fs.inotify.max_user_watches = 524288" | sudo tee /etc/sysctl.d/99-vscode-inotify.conf
然后运行：sudo sysctl --system（不是sysctl -p）
验证：sysctl fs.inotify.max_user_watches输出应带99-vscode-inotify.conf字样 - 传统方式（部分旧版或定制系统）：
追加到主配置：echo "fs.inotify.max_user_watches = 524288" | sudo tee -a /etc/sysctl.conf
再执行：sudo sysctl -p
关键点：确保输出里有fs.inotify.max_user_watches = 524288，否则检查是否有空格、引号或拼写错误 - 常见失效原因：文件名写成
99-vscode-inotify.conf.bak；漏掉--system或-p；在容器或 systemd-nspawn 中未在对应 namespace 设置
配合 files.watcherExclude 减少实际监听量
光调上限是治标，排除冗余目录才是治本，还能降低内核内存持续占用：
- 在项目根目录的
.vscode/settings.json中添加：{ "files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true, "**/build/**": true, "**/.git/**": true } } - 注意：
"**/node_modules/**"必须带末尾/**，只写"**/node_modules"会漏掉子目录 - 该设置是内核层过滤，比
search.exclude更早介入、更省资源 - 改完必须关闭并重新打开工作区，设置才生效 —— 不是保存即刻生效
真正容易被忽略的是：调高 max_user_watches 后若仍出问题，大概率是没关掉 files.watcherExclude，或者根本没完全重启 VSCode；而永久配置写错加载路径，会导致每次重启都回到默认 8192，你以为修好了，其实没生效。
