Ubuntu 22.04 安装 ROS2 官方完整版命令（最全适配，推荐 Humble）
✅ 核心前提：Ubuntu 22.04 唯一推荐安装 ROS2 Humble Hawksbill，这是官方长期支持版 (LTS)，支持到 2027 年，稳定、资料最全、兼容性最好，完美匹配 Ubuntu22.04；你的 Jetson Orin（aarch64 架构）和普通 x86_64 台式机 / 虚拟机，用这套命令完全通用，无任何差异。✅ 两种安装方式都给你，按需选择：【在线一键安装】（优先推荐，99% 场景用这个） + 【离线安装命令】（你的刚需，适配无网的 Jetson Orin）
✅ 方式一：在线一键安装 ROS2 Humble 完整版（推荐，网络通畅必用）
安装说明
- 安装的是
ros-humble-desktop-full完整版，包含所有核心功能 + 全部工具：ROS2 核心库、rqt、rviz2、gazebo 仿真器、小乌龟案例、各种功能包，一次安装到位，无需后续补装，零基础 / 开发者首选 - 所有命令直接复制粘贴执行即可，按顺序来，全程无需手动修改配置
完整安装命令（按顺序执行）
# 1. 设置UTF-8本地化编码（ROS2必须，防止中文乱码/安装报错） sudo apt update && sudo apt install locales sudo locale-gen en_US en_US.UTF-8 sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8 export LANG=en_US.UTF-8 # 2. 启用 Ubuntu universe 仓库（ROS2依赖包在该仓库，默认未开启） sudo apt install software-properties-common -y sudo add-apt-repository universe -y # 3. 添加 ROS2 官方软件源密钥和源地址 sudo apt update && sudo apt install curl -y sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null # 4. 更新软件源+系统升级（解决依赖冲突，建议执行） sudo apt update && sudo apt upgrade -y # 5. 【核心】安装ROS2 Humble 完整版（桌面全量包，推荐） sudo apt install ros-humble-desktop-full -y # 6. 安装rosdep工具（ROS2必备，解决功能包依赖，初始化rosdep用） sudo apt install python3-rosdep python3-colcon-common-extensions -y sudo rosdep init && rosdep update ✅ 关键步骤：ROS2 环境变量配置（重中之重！必做）
ROS2 安装完成后，不会自动加载环境变量，这是所有新手最常踩的坑！如果不配置，执行任何ros2命令都会提示 command not found，有两种配置方式，按需选择：
方式 A：临时生效（单次终端有效，测试用）
每次新开终端，执行这条命令即可加载 ROS2 环境：
source /opt/ros/humble/setup.bash 方式 B：永久生效（推荐，一劳永逸，必做！）
把环境变量写入系统配置文件，以后所有新开的终端，都会自动加载 ROS2 环境，无需手动执行 source 命令：
# 写入bashrc配置文件 echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc # 立即生效配置 source ~/.bashrc ✅ 验证 ROS2 是否安装成功（2 种验证方法，任选其一）
安装 + 配置完成后，执行任意一条命令，能正常运行就说明安装成功！
方法 1：运行 ROS2 官方小乌龟案例（最经典，推荐）
新开终端 2，启动键盘控制节点：
ros2 run turtlesim turtle_teleop_key 新开终端 1，启动小乌龟节点：
ros2 run turtlesim turtlesim_node ✅ 成功标志：弹出小乌龟窗口，按键盘方向键能控制乌龟移动，完美！
方法 2：运行 ROS2 环境自检命令
ros2 doctor ✅ 成功标志：终端输出 All <X> checks passed，无报错即可。
