npm install安装@esbuild/win32-x64失败的技术求助

环境信息 #

• node: 16.20.0
• npm: 10.8.3
• angular-cli: 19.0.0
• OS: win32 x64

错误详情 #

执行npm install时出现如下错误：

npm error path C:\Users\<username>\Documents\<project-name>\node_modules\esbuild
npm error command failed
npm error command C:\WINDOWS\system32\cmd.exe /d /s /c node install.js
npm error [esbuild] Failed to find package "@esbuild/win32-x64" on the file system
npm error
npm error 此问题可能是由于使用了"--no-optional"参数导致的。esbuild通过package.json的"optionalDependencies"特性来为当前平台安装正确的二进制可执行文件。安装脚本现在将尝试绕过此问题。如果失败，您需要移除"--no-optional"参数才能使用esbuild。
npm error
npm error [esbuild] 尝试使用npm安装包"@esbuild/win32-x64"
npm error [esbuild] 使用npm安装包"@esbuild/win32-x64"失败：EPERM: operation not permitted, rename 'C:\Users\<username>\Documents\<project-name>\node_modules\esbuild\lib\npm-install\node_modules\@esbuild\win32-x64\esbuild.exe' -> 'C:\Users\<username>\Documents\<project-name>\node_modules\esbuild\lib\downloaded-@esbuild-win32-x64-esbuild.exe'
npm error [esbuild] 尝试下载"https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.24.0.tgz"
npm error [esbuild] 下载"https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.24.0.tgz"失败：EPERM: operation not permitted, open 'C:\Users\<username>\Documents\<project-name>\node_modules\esbuild\lib\downloaded-@esbuild-win32-x64-esbuild.exe'
npm error C:\Users\<username>\Documents\<project-name>\node_modules\esbuild\install.js:274
npm error         throw new Error(`Failed to install package "${pkg}"`);
npm error               ^
npm error
npm error Error: Failed to install package "@esbuild/win32-x64"
npm error     at checkAndPreparePackage (C:\Users\<username>\Documents\<project-name>\node_modules\esbuild\install.js:274:15)
npm error     at processTicksAndRejections (node:internal/process/task_queues:96:5)
npm error 本次运行的完整日志可查看：C:\Users\gnagpure\AppData\Local\npm-cache\_logs\2025-01-07T13_42_31_515Z-debug-0.log

解决方案 #

1. 移除--no-optional参数 #

错误提示明确指出问题可能源于使用了--no-optional参数，esbuild依赖optionalDependencies特性安装对应平台的二进制文件。如果你的npm命令中添加了该参数，直接移除后重新执行：

npm install

2. 以管理员权限运行终端 #

EPERM错误大多是权限不足导致，右键终端（CMD/PowerShell/VS Code终端）选择以管理员身份运行，再执行npm install。

3. 清理缓存并重新安装 #

• 清理npm缓存：

npm cache clean --force

• 删除项目目录下的node_modules文件夹和package-lock.json文件
• 重新执行安装：

npm install

4. 手动安装对应平台的esbuild包 #

如果上述方法无效，手动安装指定版本的@esbuild/win32-x64：

npm install @esbuild/win32-x64@0.24.0 --save-optional

完成后再执行npm install。

5. 排查杀毒软件或防火墙干扰 #

部分杀毒软件或防火墙会拦截npm的文件重命名/写入操作，临时关闭相关软件后重试安装，确认是否是此类原因导致的权限问题。

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