【ROS2】 Conda 环境搭建（命令行版）

HAPPY酷2026-07-08 16:25

【ROS2】 Conda 环境搭建（命令行版）

适用场景 ：PyCharm 可视化创建失败 / ToS 报错 / 版本不兼容

核心原则 ：弃用 IDE 新建，强制命令行指定 Python 3.12

1. 故障复盘（为何可视化会失败）

版本陷阱 ：PyCharm 默认勾选 Python 3.13，与 ROS2 Jazzy 不兼容。
交互阻断 ：IDE 后台无法弹出 Conda ToS（服务条款）确认窗口，导致静默失败。
黑盒操作：无法直观看到下载进度和依赖冲突细节。

2. 标准操作步骤 (SOP)

Step 1: 激活 Conda 基础命令

bash 复制代码

source ~/miniconda3/etc/profile.d/conda.sh

Step 2: 接受服务条款 (解决 ToS 报错)

bash 复制代码

conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main
conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r

Step 3: 命令行创建环境 (关键步骤)

⚠️ 注意：必须显式指定 python=3.12，切勿使用默认版本。

bash 复制代码

conda create -n ros2-ws python=3.12 -y

Step 4: PyCharm 关联现有环境

打开 PyCharm -> Settings -> Project -> Python Interpreter。
点击 Add Interpreter -> Add Local Interpreter。
选择 Conda Environment -> Existing environment。
解释器路径选择：~/miniconda3/envs/ros2-ws/bin/python。

3. 避坑指南

禁止在 PyCharm 中使用 Generate new 创建 ROS2 环境（容易选错版本）。
推荐先由命令行完成环境构建与依赖安装，再由 IDE 进行"挂载"使用。