ROS2系列 (13) : 常用Git指令入门（本地Git）

在ROS2开发中，Git 是版本控制的核心工具，能帮助我们追踪代码变更、管理版本迭代、支持多人协作。本文将从本地Git仓库的角度，详解ROS2项目中常用的Git指令，让你快速掌握代码版本管理的核心流程。

一、为什么ROS2开发需要Git？

ROS2项目通常包含多个功能包（如话题节点、自定义msg包等），代码迭代频繁。Git的价值在于：

版本追踪：记录每一次代码修改，随时回退到历史版本；
协作基石：为多人协同开发ROS2功能包提供基础；
风险控制：通过分支管理实现功能迭代与稳定版本的隔离。

二、Git环境全局配置

在使用Git前，需配置全局用户信息（标识代码提交者）和默认分支：

bash 复制代码

# 配置全局用户名（替换为你的名字）
git config --global user.name "YourName"
# 配置全局邮箱（替换为你的邮箱）
git config --global user.email "your@email.com"
# 配置默认分支为master（可选，ROS2项目常见分支命名）
git config --global init.defaultBranch master
# 查看所有全局配置
git config -l

对应场景：如上图所示，这一步是Git的"身份认证"，确保每次代码提交都能明确作者。

三、初始化本地Git仓库

在ROS2工作空间（如topic_practice_ws）根目录下，初始化本地Git仓库：

bash 复制代码

# 进入工作空间根目录
cd ~/chapt3/topic_practice_ws
# 初始化Git仓库
git init

执行后，会在目录下生成.git隐藏文件夹，标志着本地仓库创建成功（可通过ls -a查看）。

四、提交代码到本地仓库

4.1 分步骤添加文件/目录

Git采用"添加（add）→ 提交（commit）"的流程管理代码变更。以ROS2功能包为例：

bash 复制代码

# 示例1：添加单个文件（如功能包的package.xml）
git add src/status_interfaces/package.xml

# 示例2：添加整个src目录（包含所有功能包）
git add src

# 示例3：添加当前目录下所有变更（推荐ROS2项目批量提交时使用）
git add .

说明：git add .会递归添加当前目录及子目录的所有变更，适合一次性提交多个ROS2功能包的修改。

4.2 提交变更到本地仓库

添加文件后，需通过git commit将变更"固化"到本地仓库：

bash 复制代码

# 提交变更，-m后跟随提交说明（需简洁描述本次修改）
git commit -m "完成状态发布与显示功能"

效果：执行后，Git会记录这次提交的作者、时间和说明，可通过git log查看历史提交。

五、使用`.gitignore`忽略不必要的文件

ROS2构建过程中会生成build、install、log等临时目录，这些文件无需纳入版本控制。通过.gitignore可忽略指定文件/目录：

5.1 创建并编辑`.gitignore`

在工作空间根目录创建.gitignore文件，添加以下规则：

复制代码

# 忽略ROS2构建目录
build/
install/
log/
# 忽略IDE配置文件（如VSCode的.vscode目录）
.vscode/

5.2 提交`.gitignore`到仓库

将.gitignore本身也纳入版本控制：

bash 复制代码

git add .gitignore
git commit -m "添加Git忽略文件，排除ROS2临时目录"

作用：后续执行git add .时，.gitignore中声明的目录会被自动跳过，避免将临时文件提交到仓库。

六、查看提交历史

通过git log可查看本地仓库的所有提交历史：

bash 复制代码

git log

输出类似：

复制代码

commit 6410b0c062fbab423f5e3d16e6d5f76d5964bb3f (HEAD -> master)
Author: Fish <fishros@foxmail.com>
Date:   Sat Aug 31 17:26:03 2024 +0800

    完成状态发布与显示功能

用途：可查看每次提交的作者、时间和说明，也可通过提交ID回退到历史版本。

总结

本文详解了ROS2本地Git仓库的核心流程：

全局配置 ：git config设置用户信息和默认分支；
仓库初始化 ：git init创建本地仓库；
代码提交 ：git add + git commit 记录代码变更；
忽略文件 ：.gitignore排除不必要的临时文件；
历史查看 ：git log追踪提交记录。

掌握这些指令后，你可以高效管理ROS2功能包的版本，为后续多人协作或代码迭代打下基础。

ROS2系列 (13) : 常用Git指令入门（本地Git）