将 note 笔记库同步到 note_sync，AI_compiler 作为 submodule

ros/ros2/安装配置/代码更新_zh.md

@@ -0,0 +1,77 @@
+# 维护 ROS 2 源代码检出
+
+## [概述](https://docs.ros.org/en/humble/Installation/Maintaining-a-Source-Checkout.html)
+
+本文档介绍如何维护从源代码构建的 ROS 2 安装。如果您已经从源代码安装了 ROS 2，并且想要更新到最新的错误修复和功能，请遵循本指南。
+
+## [更新 ROS 2 源代码](https://docs.ros.org/en/humble/Installation/Maintaining-a-Source-Checkout.html#updating-ros-2-source-code)
+
+### 1. 更新仓库列表文件
+
+首先，您需要获取最新的 `ros2.repos` 文件，该文件定义了构建 ROS 2 所需的所有仓库及其分支。
+
+```bash
+# 对于 Humble Hawksbill 版本
+cd ~/ros2_humble
+wget https://raw.githubusercontent.com/ros2/ros2/humble/ros2.repos -O ros2.repos
+```
+
+或者，如果您想使用特定分支（例如主分支）而不是发布分支：
+
+```bash
+# 使用主分支（开发版本）
+wget https://raw.githubusercontent.com/ros2/ros2/master/ros2.repos -O ros2.repos
+```
+
+### 2. 更新本地仓库
+
+使用 `vcs` 工具更新您的本地仓库：
+
+```bash
+# 更新所有仓库的远程引用
+vcs custom --args remote update
+```
+
+### 3. 下载新的源代码
+
+现在，使用新的 `ros2.repos` 文件导入并拉取最新的代码：
+
+```bash
+# 导入新仓库定义
+vcs import src < ros2.repos
+
+# 拉取所有仓库的最新代码
+vcs pull src
+```
+
+**注意**：`vcs import` 命令将覆盖 `src` 目录中现有的仓库定义。如果您有本地修改或添加了额外的仓库，请确保在运行此命令之前备份您的更改。
+
+### 4. 重新构建工作空间
+
+更新源代码后，需要重新构建工作空间：
+
+```bash
+# 返回到工作空间根目录
+cd ~/ros2_humble
+
+# 使用 colcon 重新构建
+colcon build --symlink-install
+```
+
+构建选项说明：
+- `--symlink-install`：使用符号链接而不是复制文件，这可以加快构建速度并减少磁盘空间使用
+
+### 5. 检查源代码状态
+
+要查看当前工作空间中所有仓库的状态，可以导出当前的仓库配置：
+
+```bash
+# 导出当前仓库状态
+vcs export src > my_ros2.repos
+```
+
+这将在当前目录下创建一个 `my_ros2.repos` 文件，其中包含所有仓库的当前提交哈希值。您可以将此文件用于：
+- 备份当前的源代码状态
+- 在其他机器上复制相同的配置
+- 调试构建问题
+