VSCode终端启动失败报forkpty(3) failed或EBUSY错误，大概率是系统句柄/文件描述符耗尽：Linux/macOS需调高ulimit限制，Windows需禁用ConPTY或清理命名管道，macOS还需检查pty.node权限与架构匹配性。
VSCode 终端启动失败，报 forkpty(3) failed 或 EBUSY: resource busy or locked, open '\.pipeconpty-xxx-in'，大概率是系统句柄/文件描述符耗尽，不是 VSCode 本身坏了。
Linux/macOS 下 ulimit 限制太低直接卡死 Pty 创建
VSCode 内置终端依赖 forkpty 创建伪终端，该调用会消耗一个文件描述符（fd）。默认 ulimit -n 常为 1024，而 VSCode 启动时可能同时打开多个终端、扩展进程、语言服务器，叠加后轻松突破上限。
- 临时验证：终端里运行
ulimit -n，若 ≤ 2048，基本就是瓶颈 - 立即缓解：执行
ulimit -n 4096（当前会话生效） - 永久修复需改
/etc/security/limits.conf，加两行：* soft nofile 65536* hard nofile 65536
注意：改完必须重新登录（不是重启 VSCode），否则不生效 - macOS 用户额外检查：
launchctl limit maxfiles，若显示 256/256，说明 LaunchServices 层也锁死了，需在/Library/LaunchDaemons/limit.maxfiles.plist中配置并sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
Windows 上 conhost.exe 句柄泄漏导致 pipe 占用
错误中反复出现 conpty-xxx-in 或 winpty-agent.exe 失败，常因旧 conhost 进程未释放命名管道句柄。任务管理器里能看到多个 conhost.exe 持有同名 pipe，但杀掉后新建终端又复现——说明是 VSCode 自身进程管理缺陷或 Windows 控制台子系统残留。
- 不要手动杀
conhost.exe：它由系统托管，强制终止可能触发蓝屏或终端彻底不可用 - 优先禁用 ConPTY：在 VSCode
settings.json中设"terminal.integrated.windowsEnableConpty": false，回退到 WinPTY（兼容性更好） - 清空残留 pipe：以管理员身份运行 PowerShell，执行
Remove-Item \.pipeconpty* -Force -ErrorAction SilentlyContinue（注意这不是万能解，仅对已断开的 pipe 有效） - 检查是否启用了“Windows Terminal”集成：如果装了 Windows Terminal 并设为默认，它可能劫持
conpty初始化流程，临时卸载 WT 或在 VSCode 设置中显式指定 shell 路径为cmd.exe可绕过
macOS 上 pty.node 找不到本质是权限或路径断裂
报错 dlopen(.../pty.node, ...): no such file 看似文件丢失，实则多因 macOS 安全机制拦截了动态库加载路径，尤其 VSCode 从 dmg 拖入 Applications 后未签名或未授予权限。
- 先确认文件真实存在：
ls -l "/Applications/Visual Studio Code.app/Contents/Resources/app/node_modules/node-pty/build/Release/pty.node"，若不存在，重装 VSCode（别用 brew cask，下载官方 dmg） - 若存在但报错，大概率是 Gatekeeper 阻断：右键 VSCode → “显示简介” → 勾选“仍要打开”；再进“系统设置 > 隐私与安全性 > 完全磁盘访问”，把 VSCode 拖进去
- 别碰
DYLD_LIBRARY_PATH：macOS Catalina+ 已禁用 GUI 应用读取该变量，强行设置无效还可能引发崩溃 - 检查是否运行在 Rosetta 模式：M1/M2 Mac 上，若 VSCode 是 Intel 版本（“打开方式”里标着“Rosetta”），而
pty.node是 ARM64 编译的，就会加载失败，换原生 Apple Silicon 版 VSCode
句柄数问题最隐蔽的点在于：它不报错“too many files”，而是表现为各种看似无关的失败——forkpty 失败、pipe 占用、pty.node 加载失败、甚至终端能打开但无法输入。查的时候别只盯 VSCode 日志，先看系统级资源水位。
