如何解决 VS Code 中 Yarn 无法识别的问题
当你在 VS Code 中使用 Yarn 时，有时会遇到“Yarn 无法将 yarn 项识别为 cmdlet、函数、脚本文件或可运行程序的名称”的错误。这通常是因为 Yarn 没有被添加到系统的环境变量中。本文将详细介绍解决这个问题的步骤，并为刚入行的小白提供必要的代码示例和解释。
整体流程概览
以下是解决这个问题的步骤：
| 步骤 | 描述 |
|---|---|
| 1 | 确认 Yarn 是否已安装 |
| 2 | 检查 yarn 是否在环境变量中 |
| 3 | 添加 Yarn 到系统环境变量 |
| 4 | 重启 VS Code |
| 5 | 验证 Yarn 是否正常工作 |
步骤细节
1. 确认 Yarn 是否已安装
我们首先需要检查 Yarn 是否已安装并可用。打开命令行（Windows 上为 PowerShell 或命令提示符，macOS 或 Linux 上为终端），然后输入以下命令：
yarn --version
这个命令会返回安装的 Yarn 版本。如果没有返回版本号，说明 Yarn 未安装。
若没有安装 Yarn，请按照以下步骤安装：
Windows 安装 Yarn
使用 Chocolatey 安装 Yarn（确保你已安装 Chocolatey）：
choco install yarn
注释：这个命令会通过 Chocolatey 包管理器安装 Yarn。
macOS 和 Linux 安装 Yarn
使用 npm 安装 Yarn：
npm install --global yarn
注释：这个命令会全局安装 Yarn，使其可在任何地方使用。
2. 检查 yarn 是否在环境变量中
如果 Yarn 安装成功，接下来需要确认 Yarn 是否已添加到系统环境变量中。在命令行输入以下命令：
echo $PATH
这个命令会显示系统的 PATH 环境变量。
检查输出中是否包含指向 Yarn 的目录（例如 C:\Users\<你的用户名>\AppData\Roaming\npm 或类似路径）。如果没有找到，接下来要执行步骤 3。
3. 添加 Yarn 到系统环境变量
在 Windows 上，我们需要手动添加 Yarn 到环境变量：
- 右键点击“计算机”或“此电脑” -> 选择“属性”。
- 点击“高级系统设置” -> “环境变量”。
- 在“系统变量”部分找到“Path”，并双击它。
- 点击“新建”，然后加入 Yarn 的安装路径（如
C:\Users\<你的用户名>\AppData\Roaming\npm）。 - 点击“确定”保存更改。
在 macOS 和 Linux 上，可以通过修改 .bashrc、.bash_profile 或 .zshrc 文件来添加 Yarn。以 .bashrc 为例：
echo 'export PATH="$PATH:$(yarn global bin)"' >> ~/.bashrc
source ~/.bashrc
注释：上述命令将 Yarn 的全局 bin 目录添加到 PATH 环境变量中，并刷新当前 shell。
4. 重启 VS Code
更改环境变量后必须重启 VS Code。只需关闭 VS Code，然后重新打开即可。
5. 验证 Yarn 是否正常工作
再次打开命令行，输入：
yarn --version
如果正确显示版本号，表示 Yarn 安装和配置成功，可以在 VS Code 中正常使用。
关系图
下面是一个表示上述步骤关系的 ER 图，帮助你理解每一步之间的关系：
erDiagram
A[确认 Yarn 是否已安装] ||--|| B[检查 yarn 是否在环境变量中]
B ||--|| C[添加 Yarn 到系统环境变量]
C ||--|| D[重启 VS Code]
D ||--|| E[验证 Yarn 是否正常工作]
总结
解决 VS Code 中 Yarn 无法识别的问题，主要分为确认安装、检查环境变量、添加环境变量和验证等步骤。遵循本文中的每一步，你应该能够顺利解决问题并在开发中利用好 Yarn 的便利功能。
如果你依然遇到问题，请确保按照步骤仔细检查，或在网上查找相关资料寻求进一步支持。希望这些信息能帮助你在开发路上走得更顺利！
