yarn 不是内部或外部命令，也不是可运行的程序

封面图 • 2025-11-22 • Linux

出现错误提示：

```
yarn 不是内部或外部命令，也不是可运行的程序
```

这表示你的系统无法找到 `yarn` 命令。通常有以下几种原因和解决方法：

---

## ✅ 1. **Yarn 没有安装**

如果你没有安装 Yarn，这个错误就会发生。

### 安装方式（推荐使用 npm 安装）：

```bash
npm install -g yarn
```

或者使用 [Homebrew](https://brew.sh/)（适用于 macOS）：

```bash
brew install yarn
```

---

## ✅ 2. **环境变量未配置**

安装完成后，如果仍然报错，可能是 `yarn` 的路径没有加入到系统的环境变量中。

### 检查是否已安装：

```bash
which yarn
```

- 如果返回类似 `/usr/local/bin/yarn` 或 `/opt/homebrew/bin/yarn`，说明安装了但可能没加到环境变量。
- 如果没有任何输出，说明没有安装或路径不对。

### 添加路径到环境变量（以 Linux/macOS 为例）：

打开终端，执行以下命令（根据实际安装路径修改）：

```bash
export PATH=$PATH:/usr/local/bin
```

或者添加到 `.bashrc` 或 `.zshrc` 文件中：

```bash
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.bashrc
source ~/.bashrc
```

---

## ✅ 3. **使用 npx yarn**

如果你不想全局安装 Yarn，也可以使用 `npx` 来运行它：

```bash
npx yarn
```

但这种方式每次都要带 `npx`，不太方便。

---

## ✅ 4. **检查 Node.js 是否安装**

Yarn 是基于 Node.js 的工具，确保你已经安装了 Node.js：

```bash
node -v
```

如果没有安装，可以下载并安装 [Node.js](https://nodejs.org/)。

---

## ✅ 5. **Windows 系统特别注意**

在 Windows 上安装 Yarn 后，可能需要重新启动命令行工具（如 CMD、PowerShell、WSL）才能识别新安装的命令。

---

## ✅ 6. **使用 Chocolatey 安装（Windows）**

如果你用的是 Windows，也可以通过 [Chocolatey](https://chocolatey.org/) 安装：

```bash
choco install yarn
```

---

## ✅ 7. **验证安装**

安装完成后，验证是否成功：

```bash
yarn --version
```

如果显示版本号，就说明安装成功了。

---

## 📌 总结

| 问题 | 解决方案 |
|------|----------|
| Yarn 未安装 | `npm install -g yarn` |
| 路径未配置 | 将 yarn 路径加入环境变量 |
| Windows 未重启 | 重启 CMD/PowerShell |
| Node.js 未安装 | 安装 Node.js |

---

如果你告诉我你是哪个操作系统（Windows/macOS/Linux），我可以提供更具体的安装步骤。