ROS2 的 .gitignore
适用于 ROS2 的 17 条忽略规则，可直接复制到您的仓库。
机器人操作系统 ROS 2 工作区
ROS2 的完整 .gitignore
# 由 LFGitignore - https://lfgitignore.com 生成
# 创建：2026-10-31 22:59:03 UTC
# 技术：ROS2
### ROS2 ###
# 构建输出目录
build/
install/
log/
COLCON_IGNORE
AMENT_IGNORE
*.dox
*.wikidoc
# Eclipse 项目文件
.project
# Eclipse C/C++ 项目
.cproject
# CMake 用户设置
CMakeLists.txt.user
srv/_*.py
*.pcd
*.pyc
qtcreator-*
# 用户特定设置
*.user
# Emacs 备份文件
*~
.#*
这些 ROS2 规则实际上忽略了什么
以下列出了每个忽略模式及其加入 .gitignore 的原因。
通用
| 模式 |
忽略的内容 |
build/ |
构建输出目录 |
install/ |
通用 |
log/ |
通用 |
Colcon 自定义文件
| 模式 |
忽略的内容 |
COLCON_IGNORE |
Colcon 自定义文件 |
AMENT_IGNORE |
Colcon 自定义文件 |
忽略生成的文档
| 模式 |
忽略的内容 |
*.dox |
忽略生成的文档 |
*.wikidoc |
忽略生成的文档 |
.project |
Eclipse 项目文件 |
.cproject |
Eclipse C/C++ 项目 |
CMakeLists.txt.user |
CMake 用户设置 |
srv/_*.py |
忽略生成的文档 |
*.pcd |
忽略生成的文档 |
*.pyc |
忽略生成的文档 |
qtcreator-* |
忽略生成的文档 |
*.user |
用户特定设置 |
*~ |
Emacs 备份文件 |
如何将此 .gitignore 用于 ROS2
- 复制上面的ROS2规则，或者直接下载文件。
- 在 Git 仓库根目录创建名为 .gitignore 的文件，并将规则粘贴进去。
- 如果其中一些文件已被跟踪，请运行 git rm -r --cached . 然后再次提交 - Git 仅将忽略规则应用于未跟踪的文件。
- 提交 .gitignore 以便团队中的每个人都共享相同的规则。
