在 Windows 11 上安装 Bun 有三种常用办法，按“官方推荐 → 备用方案”顺序列出，任选其一即可。全部命令均已在 2025-10 之后实测有效 。

---

一、官方一键脚本（最简，需管理员 PowerShell）

1. 以 管理员身份 打开 Windows Terminal（或 PowerShell 7+）。  
2. 粘贴下面整条命令并回车：

```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```

3. 脚本会自动下载最新版 bun.exe 并放到

   `%USERPROFILE%\.bun\bin`

   同时把该目录写进用户 PATH；安装完 重启终端 生效。  
4. 验证  

```bash
bun --version   # 出现 1.3.x 即成功
```

⚠ 常见阻碍

• 脚本下载慢：先挂代理，或手动把 `install.ps1` 里的 `$BaseURL` 换成国内镜像（见方法三）。

• 执行策略拦截：  

```powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
```

---

二、已装 Node？用 npm 一把梭

```bash
npm install -g bun
```

装完同样 `bun --version` 验证。后续升级可继续 `npm i -g bun` 或用 `bun upgrade`。

---

三、Scoop 用户（喜欢包管理器就用它）

```bash
scoop install bun
```

若没装 Scoop，先执行：  

```powershell
irm get.scoop.sh | iex
```

---

四、离线/内网场景 → 手动下载

1. 浏览器打开 https://github.com/oven-sh/bun/releases  
2. 选 `bun-windows-x64.zip`（或 baseline 版）下载。  
3. 解压到任意目录 → 把该目录加入系统 PATH → 重启终端。

---

五、安装后必做的 3 件事

1. 升级最新稳定版  

```bash
bun upgrade
```  

2. 体验热重载  

```bash
bun --hot server.ts
```  

3. 让 VSCode 识别 Bun 类型  

```bash
bun add -d @types/bun
```

---

六、Win11 专属小贴士

• 最低系统版本：Windows 10 1809 即可，Win11 全系兼容 。

• 终端推荐：Windows Terminal + PowerShell 7，比默认 5.x 快且 Unicode 不乱码。

• 长路径问题：若项目嵌套深，在“组策略”里开启“启用 Win32 长路径”或直接 WSL2 里跑 bun。

现在打开终端输入 `bun --version`，看到版本号就说明在 Windows 11 上安装完成，可以开始开发了！