# ros2

**Repository Path**: lpz1975/ros2

## Basic Information

- **Project Name**: ros2
- **Description**: 学习ros2
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-12
- **Last Updated**: 2026-02-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ROS 2最新版安装脚本

## 脚本说明

此脚本用于在Ubuntu系统上自动安装ROS 2最新版（当前为Jazzy版本）。脚本包含完整的安装步骤，包括依赖安装、源配置、ROS 2安装、环境配置和测试功能。

## 系统要求

- **操作系统**: Ubuntu 22.04 LTS 或 Ubuntu 24.04 LTS
- **架构**: x86_64
- **内存**: 至少4GB
- **磁盘空间**: 至少20GB可用空间
- **网络**: 需要互联网连接

## 使用方法

### 1. 下载脚本

```bash
# 进入/opt/ros2目录
cd /opt/ros2

# 确保脚本有执行权限
chmod +x install_ros2_latest.sh
```

### 2. 运行脚本

```bash
# 以root权限运行脚本
sudo bash install_ros2_latest.sh
```

### 3. 安装过程

脚本会自动执行以下步骤：

1. 检查系统版本和环境
2. 更新系统包
3. 安装必要的依赖
4. 安装Python依赖
5. 添加ROS 2源和密钥
6. 安装ROS 2最新版
7. 安装开发工具
8. 初始化rosdep
9. 设置环境变量
10. 测试ROS 2安装
11. 清理系统

### 4. 验证安装

安装完成后，脚本会自动测试ROS 2的安装情况：

- 检查ROS 2版本
- 运行talker/listener节点测试通信

### 5. 环境配置

脚本会自动将ROS 2环境变量添加到`~/.bashrc`文件中，新终端会自动加载ROS 2环境。

对于现有终端，请运行：

```bash
source /opt/ros/jazzy/setup.bash
```

## 注意事项

### 1. 系统兼容性

- **推荐系统**: Ubuntu 22.04 LTS 或 24.04 LTS
- **其他系统**: 可能会遇到兼容性问题，脚本会给出警告但仍会尝试安装

### 2. 网络问题

- 安装过程需要稳定的网络连接
- 如果遇到网络问题，脚本会失败并显示错误信息
- 建议在网络条件良好的环境下运行

### 3. 权限要求

- 脚本必须以root权限运行
- 使用`sudo`命令确保有足够的权限

### 4. 安装时间

- 首次安装可能需要30分钟到1小时
- 取决于网络速度和系统性能

### 5. 磁盘空间

- 确保有至少20GB的可用磁盘空间
- 安装过程中会下载和安装大量包

### 6. 冲突解决

- 如果系统中已安装ROS 1，可能会遇到环境变量冲突
- 建议在单独的终端或使用Docker容器运行不同版本的ROS

## 常见问题

### 1. rosdep初始化失败

如果遇到rosdep初始化失败，请尝试：

```bash
sudo rosdep init
sudo rosdep update
```

### 2. 节点通信测试失败

如果测试失败，请检查：
- 网络连接是否正常
- 防火墙是否阻止了ROS 2通信
- ROS 2环境变量是否正确设置

### 3. 依赖安装失败

如果依赖安装失败，请尝试：

```bash
sudo apt update
sudo apt upgrade
```

然后重新运行安装脚本。

### 4. 图形界面节点运行失败（Qt平台插件错误）

如果运行turtlesim等图形界面节点时遇到以下错误：

```
qt.qpa.xcb: could not connect to display
qt.qpa.plugin: Could not load the Qt platform plugin "xcb"
```

这是因为在没有图形界面的环境中运行需要GUI的节点。解决方案：

1. **在有图形界面的环境中运行**：确保系统有X11显示服务器
2. **安装必要的图形依赖**：
   ```bash
   sudo apt install -y libqt5gui5 libqt5widgets5 libqt5opengl5
   ```
3. **使用X11转发**：如果在远程终端，使用`ssh -X`连接
4. **使用无图形界面的节点**：如talker/listener等命令行节点

### 5. Python依赖安装失败（externally-managed-environment）

如果遇到Python依赖安装错误：

```
error: externally-managed-environment
```

这是因为Ubuntu 24.04的Python环境限制。解决方案：

```bash
# 使用apt安装Python包
sudo apt install python3-argcomplete python3-flake8

# 或使用虚拟环境
python3 -m venv ros2_venv
source ros2_venv/bin/activate
pip install argcomplete flake8
```

## 卸载方法

如需卸载ROS 2，请运行：

```bash
sudo apt remove --purge ros-jazzy-*
sudo apt autoremove
sudo rm /etc/apt/sources.list.d/ros2.list
sudo rm /usr/share/keyrings/ros-archive-keyring.gpg
```

同时从`~/.bashrc`文件中删除ROS 2相关的环境变量设置。

## 版本信息

- **脚本版本**: 2026-02-05
- **ROS 2版本**: Jazzy (2025年LTS版本)
- **支持系统**: Ubuntu 22.04/24.04 LTS

## 参考文档

- [ROS 2官方文档](https://docs.ros.org/en/jazzy/)
- [ROS 2安装指南](https://docs.ros.org/en/jazzy/Installation.html)
- [Ubuntu官方网站](https://ubuntu.com/)