VSCode调试时crypto.subtle不可用，主因是Node版本低于v19.0且未启用--experimental-webcrypto参数；v18.19.0+需在launch.json的runtimeArgs中显式添加该flag，v19.0+则开箱即用，同时须确保VSCode继承终端环境变量并彻底重启以生效。
VSCode调试时crypto.subtle不可用？先确认Node版本是否支持Web Crypto
Node.js直到v19.0才原生支持window.crypto.subtle（严格说，是globalThis.crypto.subtle），v18及更早版本默认不启用该API。你在VSCode里F5启动后报Cannot read property 'subtle' of undefined，大概率不是代码写错，而是Node版本太低。
验证方式很简单：在调试入口文件开头加一行console.log('crypto:', !!globalThis.crypto, process.version)，F5运行看输出。若process.version是v18.17.0而!!globalThis.crypto为false，就坐实了版本问题。
- v19.0+：开箱即用，无需额外flag
- v18.x：必须启动时加
--experimental-webcrypto参数，且仅限部分patch版本（如v18.19.0+）稳定支持 - v16.x及更早：即使加flag也无效，
crypto.subtle根本不存在
launch.json里怎么传--experimental-webcrypto参数？别只配runtimeExecutable
"runtimeExecutable"只指定node二进制路径，不负责传参。要让调试器真正启用Web Crypto，得把实验性flag塞进args字段——而且必须放在runtimeArgs里，不是args（后者传给你的脚本，不是Node进程本身）。
正确配置示例（适用于v18.19.0+）：
{
"configurations": [{
"type": "node",
"request": "launch",
"name": "Launch with WebCrypto",
"runtimeExecutable": "${env:NVM_BIN}/node",
"runtimeArgs": ["--experimental-webcrypto"],
"program": "${file}"
}]
}
-
runtimeArgs是Node进程启动参数，args才是你脚本的process.argv - 如果用的是v19+，删掉
runtimeArgs行反而更干净，避免冗余flag - 硬编码
runtimeExecutable路径（如/usr/local/bin/node）会导致跨机器失效，坚持用${env:NVM_BIN}/node
为什么终端里crypto可用，但VSCode调试却不行？环境变量继承没打通
你在集成终端执行node --experimental-webcrypto -e "console.log(!!crypto.subtle)"返回true，但F5调试还是undefined——说明VSCode调试器压根没读到你终端里的环境或flag。
根本原因有两个，缺一不可：
-
terminal.integrated.inheritEnv没设为true：VSCode GUI进程默认不继承shell环境变量，NVM_BIN为空 →${env:NVM_BIN}/node展开失败 → 调试器 fallback 到PATH里第一个node（通常是系统旧版） -
settings.json改完没完全退出VSCode：只是关窗口不生效，必须Cmd+Q（macOS）或File→Exit（Windows/Linux）彻底重启
验证是否打通：重启后，在集成终端运行echo $NVM_BIN，有输出；再运行nvm current，显示预期版本（如v20.15.0）；最后F5调试看process.version是否匹配。
Web Crypto跨版本行为差异：别依赖crypto.hash，改用subtle.digest
Vite 7升级时出现的crypto.hash is not a function错误，本质是误用了已废弃的Node.js私有API。Node.js v17+开始移除crypto.hash()，统一走crypto.subtle.digest()标准路径。
兼容写法（适配v18.19.0+/v19+/v20+）：
// ✅ 正确：标准Web Crypto API
async function hash(data) {
const encoder = new TextEncoder();
const digest = await crypto.subtle.digest('SHA-256', encoder.encode(data));
return Array.from(new Uint8Array(digest)).map(b => b.toString(16).padStart(2, '0')).join('');
}
// ❌ 错误：Node.js私有API，v17+已移除
// crypto.hash('sha256', data);
-
crypto.subtle.digest()返回Promise，注意await；crypto.hash()是同步函数，但已被废弃 - 算法名必须全大写字符串（
'SHA-256'），不能是'sha256'或sha256 - v18需flag、v19+免flag，但API调用方式完全一致——这才是你该写的兼容层
最易被忽略的点：Node.js版本切换后，VSCode调试器不会自动重载launch.json配置。改完runtimeArgs或runtimeExecutable，必须手动重启调试会话（Stop → F5），否则缓存的旧配置还在跑。
