Windows WSL环境运行bun提示'bun' not found错误解决方案求助

按以下顺序操作排查即可：

• 第一步先重载shell配置
  编辑完.bashrc后配置不会在当前已打开的终端自动生效，先执行命令重载：

  source ~/.bashrc
  

  执行完直接运行bun --version，如果能正常输出版本号即为修复完成，后续新开WSL终端会自动加载配置，无需重复执行source命令。

如果重载后仍然报错，继续往下排查：

• 核对环境变量配置是否正确
  重新打开~/.bashrc，确认文件末尾添加的是以下两行配置，不要写错路径：

  export BUN_INSTALL="$HOME/.bun"
  export PATH="$BUN_INSTALL/bin:$PATH"
  

  注意：WSL环境下不要写Windows盘符格式的路径，$HOME会自动映射到当前WSL发行版的用户目录，直接引用即可。
  确认配置正确后保存退出nano（按Ctrl+O回车保存，Ctrl+X退出编辑器），再执行一次source ~/.bashrc重试命令。

• 确认Bun安装文件是否完整
  如果路径配置无误仍然找不到命令，执行以下命令检查安装包是否下载成功：

  ls ~/.bun/bin/bun
  

  如果返回No such file or directory提示，说明之前的安装脚本执行失败，重新运行官方安装命令即可：

  curl -fsSL https://bun.sh/install | bash
  

  如果提示文件存在但执行报错，是WSL默认精简系统缺少运行依赖，执行命令装齐依赖即可：

  sudo apt update && sudo apt install -y unzip libatomic1
  

  依赖安装完成后再重试bun相关命令。

• 确认当前使用的shell为bash
  如果你自行修改过WSL默认shell为zsh、fish等，修改.bashrc不会对默认shell生效，需要把环境变量写到对应shell的配置文件中：

  • zsh用户：把上述两行export配置写入~/.zshrc文件末尾，执行source ~/.zshrc生效
  • fish用户：直接执行以下两行命令永久添加环境路径：

    set -Ux BUN_INSTALL $HOME/.bun
    fish_add_path $BUN_INSTALL/bin
    

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