Robot Framework IDE（RIDE）安装

这里是 Robot Framework IDE（RIDE）的官方权威下载渠道与安装指引，适配嵌入式 / HVAC 测试场景的环境配置需求：

核心官方下载链接

推荐安装步骤（Windows/macOS/Linux 通用）

1. 前置依赖：Python 3.9–3.14（推荐 3.10+）、pip 21+，先安装 wxPython（RIDE 图形界面依赖）：

   bash

   运行

   pip install -U wxPython
   

2. 安装 RIDE（稳定版）：

   bash

   运行

   pip install -U robotframework-ride
   

3. 安装开发版（如需最新功能）：

   bash

   运行

   pip install -U https://github.com/robotframework/RIDE/archive/develop.zip
   

4. 启动方式：命令行输入 ride.py，或安装后创建桌面快捷方式（Windows 安装后会提示创建）。

嵌入式测试适配提示

• 安装后可集成 STM32/nRF52 固件测试脚本，通过自定义库调用硬件接口，实现 HVAC 控制逻辑的自动化验证与质量追溯。

适配嵌入式 / HVAC 测试的RIDE 安装排错指南与依赖版本匹配清单，覆盖 Windows/macOS/Linux 常见问题，可直接用于 STM32/nRF52 固件测试环境配置。

一、依赖版本匹配清单（2026 年 2 月推荐）

二、分系统安装与启动排错指南

1. Windows 系统（高频问题与解决）

• 常见问题 1：命令行输入 ride.py 无响应 / 提示 “找不到模块”
  • 排查：Python 未加入 PATH、wxPython 版本不匹配、权限不足
  • 解决：
    1. 安装时勾选 “Add Python to PATH”，或手动添加Python安装目录\Scripts到系统 PATH。
    2. 用管理员权限执行：pip install -U wxPython==4.2.3。
    3. 重新安装依赖：pip install -U robotframework psutil robotframework-ride。
    4. 启动方式：python -m robotide.__init__ 或直接运行Scripts\ride.py。
• 常见问题 2：启动提示 “ImportError: DLL load failed”
  • 解决：安装 VC++ Redistributable（2015–2022），64 位系统必须安装 64 位版本；卸载 32 位 Python，重装 64 位。

2. macOS 系统（图形界面与权限问题）

• 常见问题 1：启动后闪退 / 提示 “无法验证开发者”
  • 解决：
    1. 打开 “系统设置→隐私与安全性”，允许 RIDE 执行（可能需点击 “仍要打开”）。
    2. 安装 Xcode 命令行工具：xcode-select --install，解决 wxPython 编译依赖。
    3. 用虚拟环境安装：python -m venv rf-env → source rf-env/bin/activate → 重新安装所有依赖。
• 常见问题 2：pip 安装 wxPython 失败
  • 解决：brew install wxwidgets 后再执行pip install wxPython，或使用预编译包：pip install -U wxPython==4.2.3。

3. Linux 系统（依赖缺失与 GUI 支持）

• 常见问题 1：启动提示 “no display name and no $DISPLAY environment variable”
  • 解决：安装图形界面依赖（Ubuntu/Debian）：sudo apt install libgtk-3-0 libwxgtk3.0-gtk3-dev；CentOS/RHEL：sudo yum install gtk3 wxGTK3-devel。
• 常见问题 2：wxPython 安装失败（无预编译包）
  • 解决：
    1. 安装编译依赖：sudo apt install build-essential python3-dev。
    2. 从源码安装 wxPython：pip install -U wxPython==4.2.3 --no-binary wxPython。

三、通用排错流程（适用于所有系统）

1. 环境验证：

   bash

   运行

   python --version  # 确认3.9+
   pip --version     # 确认pip 21+
   pip list | grep -E "robotframework|wxPython|ride"  # 检查核心包版本
   

2. 快速修复步骤：
   • 卸载冲突依赖：pip uninstall -y wxPython robotframework-ride。
   • 清理缓存：pip cache purge。
   • 重新安装：pip install -U wxPython==4.2.3 robotframework==7.3.2 robotframework-ride。
   • 强制启动：python -m robotide.__init__（绕过脚本路径问题）。
3. 嵌入式测试适配：
   • 若集成 STM32/nRF52 测试库，需确保 Python 版本与硬件 SDK 兼容，安装 pyserial（串口通信）：pip install pyserial。
   • 自定义库路径：在 RIDE 中 “Tools→Preferences→Python Path” 添加硬件测试库目录。

四、排错速查表（高频报错与解决方案）

五、安装与排错总结

1. 优先使用虚拟环境隔离依赖，避免与其他项目冲突。
2. 严格遵循版本清单安装，嵌入式场景建议 Python 3.10 + 搭配 wxPython 4.2.3。
3. 遇到启动问题先执行环境验证，再按快速修复步骤重装核心依赖。