Windows11+Node.js20.11.0环境下NextJS项目无法安装bcrypt

问题核心原因 #

从安装日志可明确两点关键问题：

1. bcrypt@5.1.1未提供适配Node.js 20.11.0的预编译二进制包，只能回退到源码编译流程
2. 已安装的VS2022缺少VC++工具集，导致node-gyp无法完成编译环境配置

可行解决方案 #

方案一：补全Visual Studio 2022的C++开发组件 #

• 打开Visual Studio Installer
• 找到已安装的VS2022 Community版本，点击「修改」
• 在「工作负载」标签下，勾选**「使用C++的桌面开发」**
• 确保右侧「可选组件」中勾选对应系统架构的「MSVC v143 - VS 2022 C++ x64/x86生成工具」
• 点击「修改」完成组件安装，重启电脑后重新执行npm i bcrypt

方案二：改用bcryptjs替代（无需编译） #

如果不想配置编译环境，可直接使用纯JS实现的bcryptjs，API与bcrypt完全兼容：

npm uninstall bcrypt
npm install bcryptjs

代码中仅需将require('bcrypt')替换为require('bcryptjs')，用法完全一致。

方案三：安装适配Node.js 20的bcrypt新版本 #

bcrypt v5.1.1对Node.js 20支持不完善，尝试安装最新版本获取适配的预编译包：

npm install bcrypt@latest

内容的提问来源于stack exchange，提问作者Shahoud Al-Rai