在 Windows 10 下搭建一个兼容性高、稳定性强的 Cordova 环境，关键在于选择经过市场长期检验、彼此兼容的版本组合。下面为您整理了一份详细的软件清单和配置步骤。

核心思路

追求稳定，我们不追求最新版本，而是选择被广泛验证过的“黄金组合”。

一、 所需软件及推荐版本

软件名称	推荐稳定版本	作用说明

Node.js

16.x LTS 或 18.x LTS

Cordova 的运行环境和包管理工具。LTS            版本长期支持，最稳定。

JDK

JDK 8 或 JDK 11 (LTS)

编译 Android 应用的必备环境。Cordov         a 对 JDK 8 和 11 支持最好。

Android SDK

API 30 (Android 11.0)

Android 开发工具包。API 30 是一个经        典且稳定的版本，兼容性极佳。

Android Studio

Arctic Fox (2020.3.1)      或 稳定新版

官方 IDE，用于安装和管理 Android SDK            和构建工具。

Git

最新版即可

许多 Cordova 插件托管在 Git 上，需                             要 Git 来下载。

Cordova                CLI

11.0.0 或 10.0.0

Cordova 命令行工具，核心。

版本选择说明：

• Node.js: v16 和 v18 是当前绝大多数项目和插件验证过的最稳定版本。避免使用最新的奇数版本。

• JDK: 强烈推荐 JDK 8，这是 Cordova Android 生态中最没有兼容性问题的版本。如果遇到警告，可升级到 JDK 11 LTS。切勿使用 JDK 17+，会导致构建失败。

• Android SDK: API 30 是一个分水岭，足够新以支持现代应用，又足够老以保证插件兼容性。

二、 详细安装与配置步骤

请严格按照顺序操作。

第1步：安装 Node.js

1. 从官网下载 Node.js 16 LTS 或 18 LTS 的 Windows 安装包 (.msi)。

2. 双击安装，基本上一路 Next 即可。安装程序会自动配置环境变量。

3. 验证安装： 打开命令提示符 (CMD) 或 PowerShell，输入：

node -v
npm -v

1. 如果能显示版本号，说明安装成功。

第2步：安装 JDK

1. 推荐安装 OpenJDK 8 (Temurin)

   • 访问 Eclipse Temurin 下载页，选择 JDK 8 LTS，下载 Windows x64 的 .msi 安装包。

   • 运行安装包，按提示完成安装。记住安装路径（例如 C:\Program Files\Eclipse Adoptium\jdk-8.0.xxx.x）。

2. 配置环境变量：

   • 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。

   • 新建系统变量：

     • 变量名：JAVA_HOME

     • 变量值：你的 JDK 安装路径 (例如 C:\Program Files\Eclipse Adoptium\jdk-8.0.372.7-hotspot)

   • 修改 Path 变量： 双击 Path，点击“新建”，添加 %JAVA_HOME%\bin。

3. 验证安装： 重新打开一个 CMD 窗口，输入：

java -version
javac -version

1. 应显示 JDK 8 的版本信息。

第3步：安装 Android Studio 和 Android SDK

1. 下载并安装 Android Studio。

2. 启动 Android Studio，在安装向导中选择“Custom”安装。

3. 选择 SDK 组件： 确保勾选：

   • Android SDK

   • Android SDK Platform

   • Android Virtual Device

4. SDK Manager 配置：

   • 安装完成后，进入主界面，点击 More Actions -> SDK Manager。

   • SDK Platforms 标签页： 勾选 Android 11.0 (R)，确保 API Level 30 被安装。

   • SDK Tools 标签页：

     • 勾选 Android SDK Build-Tools (会安装一个推荐版本，如 30.0.3，这个版本很稳定)。

     • 勾选 Android SDK Command-line Tools (latest)。

     • 勾选 Android Emulator。

     • 点击 "Apply" 开始安装。

5. 配置环境变量：

   • 新建系统变量 ANDROID_HOME：

     • 变量名：ANDROID_HOME

     • 变量值：你的 Android SDK 路径 (通常为 C:\Users\你的用户名\AppData\Local\Android\Sdk)

   • 修改 Path 变量： 添加以下三条：

     • %ANDROID_HOME%\platform-tools

     • %ANDROID_HOME%\tools

     • %ANDROID_HOME%\build-tools\30.0.3 (请替换为你实际安装的版本号)

6. 验证安装： 重新打开 CMD，输入：

adb version

1. 应显示 ADB 的版本信息。

第4步：安装 Cordova 和创建项目

1. 安装 Cordova CLI： 在 CMD 中运行：

npm install -g cordova@11.0.0

-g 表示全局安装，@11.0.0 指定了稳定版本。

2.验证安装：

cordova -v

应显示 11.0.0。

3.创建并测试你的第一个项目：

# 进入你的工作目录
cd C:\MyProjects
# 创建 Cordova 项目
cordova create HelloWorld com.example.helloworld HelloWorld
cd HelloWorld
# 添加 Android 平台
cordova platform add android@10.1.2
# 构建项目
cordova build android

如果构建过程没有报错，并在platforms\android\app\build\outputs\apk\debu目录下生成了.apk文件，那么恭喜你，环境已经完全配置成功！