VS Code使用Git报spawn EBADF错误、运行卡顿如何解决

故障现象 #

• 运行环境：2020款Mac Pro
• 异常表现：VS Code内执行Git操作、全局文件搜索时响应速度极慢，频繁抛出spawn EBADF错误，提示信息关联磁盘不可用
• 核心诉求：区分故障为硬件损坏导致，或存在可落地的修复路径

排查顺序（优先排除软件故障，同类场景90%以上问题无需更换硬件） #

1. VS Code侧配置修复（最高发诱因） #

spawn EBADF本质是进程尝试访问无效的文件描述符，绝大多数情况是VS Code的Git自动扫描逻辑或缓存损坏导致：

• 关闭无意义的递归仓库扫描：打开VS Code设置，搜索git.autoRepositoryDetection，将参数值修改为false，避免VS Code自动扫描到无权限的系统目录、失效挂载点，耗尽文件句柄触发报错。
• 清理损坏的工作区缓存：完全退出VS Code后，在终端执行以下命令删除历史工作区缓存：

rm -rf ~/Library/Application\ Support/Code/User/workspaceStorage/*

重启VS Code后重新打开目标项目测试即可，缓存中残留的失效文件句柄引用是该错误的最常见原因。

• 插件冲突排查：先在终端进入项目目录执行git status，如果终端下Git操作速度完全正常，可直接排除Git本身与磁盘硬件问题，此时禁用所有第三方Git增强类插件，逐个启用二分定位冲突插件即可，不少第三方Git插件会大量占用文件句柄资源触发阈值。

2. macOS系统层面修复 #

• 修复磁盘权限异常：打开系统自带磁盘工具，选中系统所在卷宗，点击「急救」执行权限修复，2020款Mac Pro在升级macOS版本、开启FileVault全磁盘加密后，偶发应用访问用户目录权限异常，会弹出磁盘不可用的假提示。
• 调高文件句柄上限：macOS默认给GUI应用分配的单进程文件句柄上限仅256，文件量较大的项目很容易打满阈值触发EBADF错误，可在终端执行以下命令临时调高上限验证：

ulimit -n 65536

如果调整后报错消失，将该配置写入对应shell的配置文件即可永久生效。

• 清理失效挂载点：打开访达检查侧边栏是否存在灰色的、无法正常访问的网络挂载盘、外接磁盘镜像，这类失效挂载点被VS Code扫描时会直接返回磁盘不可用错误，可通过diskutil list找到对应挂载点，执行umount命令强制卸载即可。

3. 硬件故障判定标准 #

只有完成以上所有软件层面排查后，终端下执行本地文件复制、原生Git操作依然卡顿、返回IO错误，且磁盘工具急救扫描出无法修复的坏块提示时，才判定为SSD硬件故障。2020款Mac Pro的SSD为可插拔设计，直接更换兼容的PCIe接口SSD即可解决。

内容的提问来源于stack exchange，提问作者Petr