node.js 启动报 crypto 模块不可用，本质是 openssl 动态库缺失或链接失败；需通过 ldd/dumpbin 验证库存在性，并在 vscode 终端配置 ld_library_path/dyld_library_path 或系统 path，或改用静态链接的官方二进制包。
Node.js 启动时直接报错 Cannot load crypto module 或 Error: Cannot find module 'node:https'，基本可以断定是 OpenSSL 动态库缺失或链接失败 —— 这不是代码写错了，而是运行时环境缺了底层依赖。
为什么VSCode终端里跑Node会提示crypto模块不可用
VSCode 默认复用系统 Shell（如 PowerShell、zsh 或 bash），但它不自动继承某些系统级动态库路径（尤其是 OpenSSL 的 libssl.so / libcrypto.so 或 Windows 下的 libeay32.dll / ssleay32.dll）。当 Node.js 编译时启用了 --shared-openssl（常见于自编译或某些 Linux 发行版精简包），它会在运行时动态加载这些库；若找不到，node:crypto 就初始化失败，连带 node:https 报错。
- 典型错误现象：
Error: error:0308010C:digital envelope routines::unsupported或启动即崩，堆栈里没有你的代码，只有internal/crypto相关路径 - 不是
npm install能解决的问题 —— 这跟node_modules无关 - 在系统终端（如 GNOME Terminal、iTerm）里能跑，但在 VSCode 集成终端里不行，大概率是环境变量没透传过去
检查OpenSSL库是否真的缺失
先确认问题根源，别急着改配置：
微软正式发布 Visual Studio Code 1.118 版本 。本次更新重点强化了 AI 开发体验与企业管理能力，其中最引人注目的是新增 Copilot CLI 远程控制功能，允许开发者通过手机或网页远程监控和接管 AI 会话 。同时，为了提高 AI 的运行性价比，新版本优化了令牌缓存策略以降低成本 。此外，1.118 版还引入了 Chronicle 本地历史追踪、TypeScript 7.0 支持以及更严格的企业级访问管控 。
- Linux/macOS：运行
ldd $(which node) | grep ssl，如果输出为空或显示not found，说明 OpenSSL 库没被链接上 - Windows：用
dumpbin /dependents "$(where node)"（需 VS 工具链）或Dependencies.exe打开node.exe，看是否缺失libeay32.dll等 - 统一验证法：在 VSCode 终端执行
node -p "require('node:crypto').randomBytes(4).toString('hex')"，报错就坐实 crypto 不可用
让VSCode终端正确加载OpenSSL路径
关键不是重装 Node，而是让集成终端知道 OpenSSL 库在哪。不同系统处理方式不同：
- Linux（Ubuntu/Debian）：
export LD_LIBRARY_PATH="/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH"加到 VSCode 终端的启动配置里（比如~/.bashrc或~/.zshrc），然后重启 VSCode - macOS（M1/M2）：
export DYLD_LIBRARY_PATH="/opt/homebrew/opt/openssl@3/lib:$DYLD_LIBRARY_PATH"（Homebrew 安装的 OpenSSL 3 路径，用brew --prefix openssl@3确认） - Windows：把 OpenSSL 的
bin目录（如C:\OpenSSL-Win64\bin）加到系统PATH，并确保 VSCode 是从新环境启动的（任务管理器里杀掉所有 Code.exe 进程再开） - VSCode 特殊情况：如果用了 Remote-SSH 或 Dev Container，必须在远程环境里单独配置，本地
settings.json无效
避免依赖动态OpenSSL的Node构建
如果你控制 Node 构建过程（比如用 nodejs-source 编译），最彻底的解法是禁用共享 OpenSSL：
- 编译时加
--without-ssl（不推荐，HTTPS 功能全失）或--with-openssl=static（推荐） - 使用官方二进制包（nodejs.org 下载的 .tar.xz 或 .msi）—— 它们自带静态链接的 OpenSSL，不会出现运行时找不到库的问题
- Docker 场景下，在
Dockerfile里显式安装libssl1.1（Debian）或openssl-libs（Alpine），比修环境变量更可靠
真正容易被忽略的是：VSCode 集成终端的环境变量继承逻辑和 GUI 应用一致，但很多人只改了 Shell 配置文件，却没意识到 VSCode 可能是通过桌面环境（如 Gnome）启动的，此时它读的是 ~/.profile 而非 ~/.bashrc —— 检查 $SHELL 和实际生效的配置文件，比反复试 export 更省时间。
