这个错误的核心原因是 Node.js 未正确安装或未配置环境变量,导致系统无法识别 npx 命令(npx 是 Node.js 自带的包执行工具,随 npm 一起安装)。以下是分步骤解决方案:

一、先检查 Node.js 是否已安装

首先确认你的电脑是否真的安装了 Node.js(npx 依赖 Node.js 环境):

  1. 打开 新的命令提示符(CMD)PowerShell(不要用之前报错的窗口,环境变量修改后需重启终端)。
  2. 执行以下命令:
    node -v  # 查看 Node.js 版本
    npm -v   # 查看 npm 版本
    
  3. 结果判断
    • 如果提示“‘node’ 不是内部或外部命令…”:说明 Node.js 未安装,直接看步骤二。
    • 如果能显示版本号(如 v16.18.0v18.17.0):说明 Node.js 已安装,但环境变量未配置,跳至步骤三。

二、未安装 Node.js:重新安装(关键步骤)

  1. 下载 Node.js
    访问 Node.js 官网,选择 “Windows 安装程序”(建议下载 LTS 长期支持版,如 v20.x 或 v18.x,兼容性更好)。

  2. 安装 Node.js(注意勾选环境变量)

    • 双击安装包,点击“下一步”直至“自定义安装”页面,保持默认选项不变(默认会安装 nodenpm 及自动配置环境变量)。
    • 关键步骤:在“工具 for Node.js 开发”页面,务必勾选“Add to PATH”(自动添加环境变量,避免手动配置),然后继续安装。
    • 安装完成后,点击“Finish”。

三、已安装 Node.js 但环境变量未配置:手动修复

如果 node -v 提示命令不存在,但你确认已安装 Node.js,需手动配置环境变量:

  1. 找到 Node.js 安装路径

    • 默认安装路径通常是:C:\Program Files\nodejs(64位系统)或 C:\Program Files (x86)\nodejs(32位系统)。
    • 若忘记路径:打开“此电脑”→ 搜索“nodejs”文件夹,找到后复制完整路径(如 C:\Program Files\nodejs)。
  2. 配置环境变量

    • 右键点击“此电脑”→ “属性”→ “高级系统设置”→ “环境变量”。
    • 在“系统变量”中找到 Path → 双击编辑 → 点击“新建”→ 粘贴刚才复制的 Node.js 路径(如 C:\Program Files\nodejs)→ 点击“确定”保存所有窗口。

四、验证环境是否修复

  1. 重启终端:关闭所有已打开的 CMD/PowerShell 窗口(环境变量修改后需重启终端生效)。
  2. 重新检查
    打开新的 CMD,执行以下命令,若能显示版本号则说明环境已修复:
    node -v  # 示例输出:v20.15.0
    npm -v   # 示例输出:10.7.0
    npx -v   # 示例输出:10.7.0(能显示则 npx 可用)
    

五、重新执行创建命令

环境修复后,回到你的项目目录,重新执行创建 Vue3+TS 版 uni-app 的命令:

  1. 进入目标目录(如你之前的 HBuilderProjects 文件夹):
    cd C:\Users\23779\Documents\HBuilderProjects
    
  2. 执行创建命令:
    npx degit dcloudio/uni-preset-vue#vite-ts uni-app-vue3-ts
    
  3. 等待命令执行完成:
    • 首次执行可能会下载 degit 工具,稍等片刻;
    • 下载完成后会自动生成 uni-app-vue3-ts 项目文件夹。

六、后续:安装项目依赖

项目创建后,进入项目目录并安装依赖:

cd uni-app-vue3-ts  # 进入项目文件夹
npm install         # 安装依赖(需等待 1-3 分钟)

常见问题补充

  • 如果执行 npx 时提示“权限不足”:右键点击 CMD → 选择“以管理员身份运行”,再执行命令。
  • 如果 degit 下载缓慢:可配置 npm 淘宝镜像加速(执行一次即可):
    npm config set registry https://registry.npm.taobao.org
    

按照以上步骤操作,即可解决 npx 命令无法识别的问题,并成功创建 Vue3+TypeScript 版的 uni-app 项目。

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐