Windows下React+React Native项目npm install失败求助

问题根源 #

shellcheck的install.sh是为类Unix系统（Mac/Linux）编写的shell脚本，Windows默认的CMD或PowerShell不支持shell语法（比如报错里的.是shell的source命令，Windows没有对应的原生支持），所以直接在Windows原生终端执行npm install会触发这个错误。

有效解决方案 #

1. 用Git Bash或WSL执行npm install（推荐）

• 安装Git for Windows（自带Git Bash），或者启用Windows的WSL（Windows Subsystem for Linux）
• 打开Git Bash/WSL终端，切换到项目根目录
• 确认当前环境的Node.js和npm版本：执行node -v和npm -v，确保是项目要求的16.15.1和8.11.0（如果nvm在这个环境没配置，重新用nvm切换版本）
• 执行npm install，这类终端支持shell脚本语法，能正常运行install.sh完成shellcheck的安装

2. 临时跳过脚本执行（应急方案）

如果只是想先完成依赖安装，后续再处理shellcheck，可以执行：

npm install --ignore-scripts

⚠️ 注意：这个命令会跳过所有依赖的安装脚本，可能导致项目缺少shellcheck这类工具，后续需要手动补装相关依赖，不建议长期使用。

3. 手动安装Windows版shellcheck

• 下载shellcheck的Windows二进制包（无需脚本安装）
• 解压后将shellcheck.exe所在的文件夹路径添加到系统环境变量PATH中
• 回到项目终端，执行shellcheck --version确认安装成功
• 再执行npm install，此时npm会检测到shellcheck已存在，跳过对应的install.sh脚本执行

额外注意事项 #

• 用WSL时，尽量将项目放在WSL的内部文件系统（比如/home/你的用户名/项目名），避免Windows挂载目录的权限或性能问题
• Git Bash中使用nvm时，确保nvm的配置文件（比如.bashrc）已正确加载，避免版本切换失效

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