Windows系统下Mediasoup 3版本安装失败问题求助

执行 npm i mediasoup --save 安装Mediasoup 3，ninja、meson等依赖已成功安装，但出现以下错误：

$ npm i mediasoup --save
some dependencies like ninja and meson are installed successful.
/f/allMy/Projects/Practice/WebRTC/Mediasoup/node_modules/mediasoup/worker/out/pip/bin/meson setup \    
npm ERR!                --prefix /f/allMy/Projects/Practice/WebRTC/Mediasoup/node_modules/mediasoup/worker/out/Release \
npm ERR!                --bindir '' \
npm ERR!                --libdir '' \
npm ERR!                --buildtype release \
npm ERR!                -Db_ndebug=true \
npm ERR!                -Db_pie=true \
npm ERR!                -Db_staticpic=true \
npm ERR!                --reconfigure \
npm ERR!                --vsenv \
npm ERR!                /f/allMy/Projects/Practice/WebRTC/Mediasoup/node_modules/mediasoup/worker/out/Release/build || \
npm ERR!                /f/allMy/Projects/Practice/WebRTC/Mediasoup/node_modules/mediasoup/worker/out/pip/bin/meson setup \
npm ERR!                        --prefix /f/allMy/Projects/Practice/WebRTC/Mediasoup/node_modules/mediasoup/worker/out/Release \
npm ERR!                        --bindir '' \
npm ERR!                        --libdir '' \
npm ERR!                        --buildtype release \
npm ERR!                        -Db_ndebug=true \
npm ERR!                        -Db_pie=true \
npm ERR!                        -Db_staticpic=true \
npm ERR!                        --vsenv \
npm ERR!                        /f/allMy/Projects/Practice/WebRTC/Mediasoup/node_modules/mediasoup/worker/out/Release/build
npm ERR! The Meson build system
npm ERR! Version: 0.61.5
npm ERR! Source dir: F:\allMy\Projects\Practice\WebRTC\Mediasoup\node_modules\mediasoup\worker
npm ERR! Build dir: F:\allMy\Projects\Practice\WebRTC\Mediasoup\node_modules\mediasoup\worker\out\Release\build
npm ERR! Build type: native build
npm ERR! Project name: mediasoup-worker
npm ERR! Project version: undefined
npm ERR!
npm ERR! meson.build:1:0: ERROR: Could not find C:\Program Files (x86)\Microsoft Visual Studio\Installer\vswhere.exe
npm ERR!
npm ERR! A full log can be found at F:\allMy\Projects\Practice\WebRTC\Mediasoup\node_modules\mediasoup\worker\out\Release\build\meson-logs\meson-log.txt
npm ERR! make: Leaving directory `/f/allMy/Projects/Practice/WebRTC/Mediasoup/node_modules/mediasoup/worker'    
npm ERR! Usage:   
npm ERR!   c:\Users\tonys\AppData\Local\Programs\Python\Python311\python3.exe -m pip install [options] <requirement specifier> [package-index-options] ...
npm ERR!   c:\Users\tonys\AppData\Local\Programs\Python\Python311\python3.exe -m pip install [options] -r <requirements file> [package-index-options] ...
npm ERR!   c:\Users\tonys\AppData\Local\Programs\Python\Python311\python3.exe -m pip install [options] [-e] <vcs project url> ...
npm ERR!   c:\Users\tonys\AppData\Local\Programs\Python\Python311\python3.exe -m pip install [options] [-e] <local project path> ...
npm ERR!   c:\Users\tonys\AppData\Local\Programs\Python\Python311\python3.exe -m pip install [options] <archive 
url/path> ...
npm ERR!
npm ERR! no such option: --system
npm ERR! Directory does not contain a valid build tree:
npm ERR! F:\allMy\Projects\Practice\WebRTC\Mediasoup\node_modules\mediasoup\worker\out\Release\build
npm ERR! make: *** [setup] Error 1
npm ERR! npm-scripts.js [ERROR] executeCmd() failed, exiting: Error: Command failed: make -C worker

环境信息

• Python：3.11
• VSCode：1.77.3
• Node.js：16.13.1

已尝试用Yarn安装，问题未解决。

1. 修复vswhere.exe缺失问题 #

错误核心提示找不到vswhere.exe，这是Windows平台构建C++项目的必要工具：

• 安装Visual Studio Build Tools 2019/2022，安装时必须勾选「C++开发工具」和「Windows SDK」组件。
• 若已安装Visual Studio，打开Visual Studio Installer，检查是否安装了「Visual Studio Installer」组件，或直接选择修复安装。
• 确认C:\Program Files (x86)\Microsoft Visual Studio\Installer路径已加入系统环境变量PATH，若未添加手动补上。

2. 解决pip--system参数错误 #

Python 3.11的pip已移除--system选项，但Mediasoup 3的构建脚本仍在使用该参数：

• 降级Python至3.9或3.10版本（Mediasoup 3官方推荐Python版本为3.7-3.10，对3.11兼容性较差）。
• 不推荐修改node_modules内的构建脚本移除--system参数，后续依赖更新会覆盖修改。

3. 其他排查步骤 #

• 以管理员身份运行终端（CMD/PowerShell）执行安装命令，避免权限不足问题。
• 删除项目下的node_modules文件夹、package-lock.json和yarn.lock文件，重新执行安装命令。
• 确保Windows系统已安装make工具，可通过Chocolatey安装：choco install make，并将其路径加入PATH。

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