已安装Visual Studio 2022仍无法执行yarn install的问题求助

问题概述 #

克隆项目后执行yarn install失败，报错核心为hnswlib-node模块的node-gyp rebuild命令失败，提示已找到Visual Studio 2022但缺少VC++工具集，无法完成编译。

解决步骤 #

1. 补装Visual Studio 2022的VC++工具集 #

• 打开Visual Studio Installer，找到已安装的「Visual Studio 2022 Community」，点击「修改」
• 在「工作负载」标签下，确保勾选「桌面开发使用C++」
• 切换到「单个组件」标签，确认勾选以下关键组件：
  • MSVC v143 - VS 2022 C++ x64/x86生成工具（根据你的Node.js架构选择，通常选x64）
  • Windows 10 SDK（或Windows 11 SDK，匹配你的系统版本）
  • C++ CMake工具 for Windows
• 点击「修改」完成安装，安装完成后重启电脑

2. 配置node-gyp的Python路径（避免路径异常） #

• 打开管理员权限的命令提示符，执行以下命令（替换为你的Python实际安装路径，不要用WindowsApps中的快捷路径）：

  npm config set python "C:\Program Files\Python311\python.exe"
  

3. 清理依赖后重新安装 #

• 删除项目目录下的node_modules文件夹、yarn.lock文件，以及提示存在的package-lock.json文件
• 打开终端（VS Code终端或PowerShell），进入项目目录，重新执行：

  yarn install
  

额外排查（若以上步骤无效） #

• 使用Visual Studio自带的「开发者命令提示符」运行yarn install，确保编译环境变量正确加载
• 检查Node.js版本是否与项目兼容，可尝试切换到项目推荐的Node.js版本（使用nvm管理版本更方便）

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