VSCode因子进程（如tsserver、exthost）大量打开文件句柄导致fd耗尽而崩溃，Linux/macOS默认上限1024易被大型项目突破，表现为EMFILE错误或静默失败；需通过lsof验证、ulimit调高系统限制，并配置watcherExclude等减少实际占用。
为什么VSCode会因文件描述符耗尽而崩溃
VSCode 本身不直接管理文件描述符（fd），但它的多个子进程——尤其是 Extension Host、TypeScript 语言服务器（tsserver）、搜索服务（searchService）和 watcher 进程——会大量打开文件句柄。Linux/macOS 默认单进程 fd 上限通常是 1024，大型项目（含 node_modules、.git、大量日志或 JSON 文件）一启动就可能突破这个限制，导致 tsserver 拒绝响应、exthost 静默退出、甚至报错 EMFILE: too many open files 或直接卡死无提示。
快速验证是否是 fd 耗尽
别猜，先查真实值。在 VSCode 终端里运行：
lsof -p $(pgrep -f "Code Helper.*Renderer\|exthost") | wc -l
如果结果 > 1000，基本可确认；再对比系统上限：
ulimit -n
若输出是 1024 或 256，就是瓶颈所在。注意：macOS Catalina+ 默认限制更严，且 ulimit 在 VSCode 终端里可能继承自 GUI 环境，实际值比终端手动执行 ulimit -n 显示的更低。
- Windows 不受此限制（使用不同句柄模型），无需查 fd
- Remote-SSH 场景下，要登录远端机器查
ulimit -n和lsof -p $(pgrep -f "node.*tsserver\|exthost") - VSCode 启动后立即查，别等崩溃——很多插件（如 ESLint、GitLens）在初始化阶段就疯狂 open() 文件
永久提高 fd 限制（Linux/macOS）
只改当前 shell 的 ulimit -n 65536 对 VSCode GUI 启动无效——它不走你的 shell 初始化链路。必须从系统级注入：
macOS（Apple Silicon）：编辑 /opt/homebrew/etc/bashrc（如果你用 Homebrew 安装 bash）或 ~/.zshrc，加一行：
ulimit -n 65536
但更可靠的是设 launchd 限制（GUI 应用真正继承的来源）：
mkdir -p ~/Library/LaunchAgents
echo '<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>my.limit</string>
<key>ProgramArguments</key>
<array>
<string>sh</string>
<string>-c</string>
<string>ulimit -n 65536</string>
</array>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>' > ~/Library/LaunchAgents/my.limit.plist
launchctl load ~/Library/LaunchAgents/my.limit.plist
Linux（systemd）：在 ~/.config/systemd/user.conf 加：
DefaultLimitNOFILE=65536
然后运行 systemctl --user daemon-reload。
- 改完必须完全退出 VSCode（不是 reload window），再重新启动才生效
- 别设成 1048576 —— 过高反而触发内核资源保护，某些云服务器会直接拒绝
- 检查是否生效：启动 VSCode 后，在终端里执行
cat /proc/$(pgrep -f "Code Helper.*Renderer")/limits | grep "Max open files"
配合 fd 优化的 VSCode 配置
光提上限不够，得减少实际消耗。重点关掉“盲扫型”监听：
在工作区 .vscode/settings.json 中加：
"files.watcherExclude": {
"**/node_modules/**": true,
"**/dist/**": true,
"**/build/**": true,
"**/*.log": true,
"**/*.jsonl": true
},
"search.exclude": {
"**/node_modules/**": true,
"**/dist/**": true
},
"typescript.preferences.includePackageJsonAutoImports": "auto"
files.watcherExclude 直接让 VSCode 的底层 inotify 不注册这些路径，省下数百个 fd；search.exclude 防止 searchService 扫描时反复 open 文件；关闭 includePackageJsonAutoImports 可避免 tsserver 对每个 package.json 做深度解析。
- 禁用 GitLens 的 “File System Watcher” 选项（设置里搜
gitlens.fsWatcher），它默认监听整个工作区，fd 开销极大 - Remote-SSH 场景下，远端也要同步配
files.watcherExclude和remote.SSH.remoteServerEnv，否则 fd 耗尽发生在服务器上 - 如果项目含大量小文件（如图标、测试 fixture），考虑用
**/icons/**这类更细粒度排除，而不是全开**/assets/**
fd 上限问题最麻烦的地方在于：它不报错，只静默失败。tsserver 可能返回空补全、exthost 可能突然消失、搜索变慢——这些看似无关的症状，根源常是同一个 EMFILE。动手前先 lsof 查，改完后用 /proc/PID/limits 验证，别依赖猜测。
