已安装Bun但仅--version命令可用 其余指令无响应如何修复

按故障出现概率从高到低依次排查：

• 排查安装路径异常
  先执行对应命令确认Bun二进制文件所在路径：
  • Linux/macOS 终端执行：which bun
  • Windows PowerShell 执行：Get-Command bun | Select-Object Source
    如果返回的路径包含中文、全角字符、空格，或者位于Windows系统Program Files等权限受限目录，会直接导致Bun子命令加载时静默挂起，此时完全卸载当前Bun，重新安装到纯英文路径、无特殊字符的用户目录下即可修复。
• 排查权限与安全软件拦截
  • Windows环境右键选择「以管理员身份运行」启动终端，再重试Bun相关命令，非管理员权限下Bun写入全局缓存、创建子进程时可能无提示挂起。
  • 临时关闭第三方杀毒软件、系统Defender实时防护后重试，部分安全软件会无提示拦截Bun的文件读写、子进程创建逻辑，造成进程假死。
  • Linux/macOS环境执行chmod +x $(which bun)，确认Bun二进制文件持有可执行权限，权限缺失时部分子命令无法正常启动。
• 排查缓存与配置损坏
  • 执行bun pm cache rm清空Bun全局包缓存，缓存文件索引损坏时，所有涉及包管理、文件读写的Bun命令都会卡在加载阶段无任何输出。
  • 重命名Bun全局配置目录做隔离测试，排除配置、全局包冲突问题：

    Linux/macOS 终端执行：
    mv ~/.bun ~/.bun.bak
    Windows PowerShell 执行：
    Rename-Item -Path $env:USERPROFILE\.bun -NewName .bun.bak
    操作完成后重启终端再测试Bun命令，如果功能恢复正常，说明故障由旧配置损坏、全局安装的第三方包冲突导致。

• 排查版本兼容问题
  • 若当前安装的是1.0正式版之前的早期预览版本，直接覆盖安装最新稳定版即可，早期预览版存在大量多系统兼容bug，会触发子命令无响应问题。
  • 最新稳定版仍存在故障的，可执行bun upgrade --canary切换到canary每日构建版验证，部分小众系统、特定硬件环境的兼容问题会优先在canary渠道修复。

注意：所有排查操作前请先结束终端里残留的Bun相关进程，避免文件占用导致操作无效

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