npm与npx命令异常：Vite运行及shadcn-ui初始化报错
2026-7-5
问题解决方案
1. SyntaxError: Unexpected token '??=' 与 ERR_UNKNOWN_BUILTIN_MODULE 错误
这两个错误本质是Node.js版本不兼容导致的：
??=（空值赋值操作符）需要Node.js 16.11.0及以上版本支持node:timers/promises模块在Node.js 15.0.0之后才被引入
解决步骤：
- 检查当前终端实际运行的Node版本：
node -v，如果版本低于16.11.0，说明你所谓的"更新至最新"未生效（可能存在多版本Node环境，比如nvm未切换到正确版本） - 切换到最新稳定版Node：
- 若用nvm管理：
nvm use stable - 直接从官网下载最新版覆盖安装
- 若用nvm管理：
- 清理npm缓存避免残留问题：
npm cache clean --force
2. npm install 速度极慢
- 切换国内npm镜像源：
npm config set registry https://registry.npmmirror.com - 推荐使用pnpm替代npm，安装速度更快且缓存复用性更强：
npm install -g pnpm
3. Yarn初始化shadcn-ui无交互提示
shadcn-ui的init命令在Yarn环境下默认可能跳过交互，可通过以下方式解决：
- 强制开启交互模式执行：
yarn dlx shadcn-ui@latest init --interactive - 手动创建项目根目录下的
components.json文件，参考shadcn-ui默认配置模板填写后，再执行组件安装命令
内容的提问来源于stack exchange，提问作者Mahan Tehrani
相关产品推荐
相关产品推荐
