方案 1:首选 → 用 Appium Desktop(带内置 Server,无需命令行)
这是最简单的方式,无需配置环境变量,下载可视化安装包即可使用:
步骤 1:下载 Appium Desktop
- 下载地址:https://github.com/appium/appium-desktop/releases(选择对应系统版本,Windows 选
.exe安装包); - 注意:Appium Desktop 包含「Server+Inspector」,无需单独装 Node.js 或配置环境变量。
步骤 2:安装并启动 Server
- 安装完成后打开 Appium Desktop;
- 保持默认配置(Host:
0.0.0.0,Port:4723),点击「Start Server v2.x.x」按钮; - 看到日志显示
Appium REST http interface listener started on 0.0.0.0:4723→ 说明 Server 启动成功(无需输任何命令)。
步骤 3:连接设备
回到 Appium Inspector(若用的是单独的 Inspector,需在 Server 配置页填127.0.0.1:4723/wd/hub),修正 Capabilities 参数后点击「Start Session」即可。
方案 2:修复命令行环境(适合想使用命令行的用户)
若你想继续用appium命令,需先安装 Node.js 并配置环境变量:
步骤 1:安装 Node.js(必装)
- 下载地址:https://nodejs.org/zh-cn/download/(选 LTS 长期支持版,Windows 选 64 位安装包);
- 安装时勾选「Add to PATH」(默认已勾选,关键!),一路下一步完成安装。
步骤 2:验证 Node.js 安装
打开新的 CMD 窗口(必须新开,环境变量才生效),执行:
node -v # 输出v20.x.x等版本号,说明安装成功
npm -v # 输出10.x.x等版本号,说明npm安装成功
步骤 3:全局安装 Appium
在 CMD 中执行:
npm install -g appium
# 安装安卓必备驱动
appium driver install uiautomator2
步骤 4:验证 Appium 安装
执行:
appium -v # 输出2.x.x版本号,说明安装成功
此时再执行 appium --allow-cors 就能正常启动 Server 了。
(可选)若仍提示「不是内部命令」→ 手动配置环境变量
- 找到 npm 全局包路径:执行
npm config get prefix,复制输出的路径(如C:\Users\32945\AppData\Roaming\npm); - 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」;
- 在「系统变量」的「Path」中添加上述路径,点击确定;
- 重启 CMD 窗口,重新执行
appium -v验证。
总结
- 优先选「方案 1(Appium Desktop)」,无需配置环境变量,下载安装后直接启动 Server,避开命令行坑;
- 若想使用命令行,需先装 Node.js(勾选 Add to PATH)→ 全局装 Appium → 验证安装,即可解决
appium命令无法识别的问题; - 解决完环境问题后,再回到 Appium Inspector 修正 Capabilities 参数(deviceName/V2338A、udid/10AE1F2FHF0012S),即可成功连接设备。