ROS 的 .gitignore
适用于 ROS 的 36 条忽略规则,可直接复制到您的仓库。
机器人操作系统 (ROS 1) 工作区
ROS 的完整 .gitignore
# 由 LFGitignore - https://lfgitignore.com 生成
# 创建:2026-10-31 21:52:41 UTC
# 技术:ROS
### ROS ###
# 构建输出目录
build/
devel/
# Eclipse 输出目录
bin/
logs/
# 库目录
lib/
msg_gen/
srv_gen/
msg/*Action.msg
msg/*ActionFeedback.msg
msg/*ActionGoal.msg
msg/*ActionResult.msg
msg/*Feedback.msg
msg/*Goal.msg
msg/*Result.msg
msg/_*.py
build_isolated/
devel_isolated/
*.cfgc
/cfg/cpp/
/cfg/*.py
*.dox
*.wikidoc
# Eclipse 项目文件
.project
# Eclipse C/C++ 项目
.cproject
# CMake 用户设置
CMakeLists.txt.user
srv/_*.py
*.pcd
*.pyc
qtcreator-*
# 用户特定设置
*.user
/planning/cfg
/planning/docs
/planning/src
# Emacs 备份文件
*~
.#*
CATKIN_IGNORE
这些 ROS 规则实际上忽略了什么
以下列出了每个忽略模式及其加入 .gitignore 的原因。
通用
| 模式 |
忽略的内容 |
build/ |
构建输出目录 |
devel/ |
通用 |
bin/ |
Eclipse 输出目录 |
logs/ |
通用 |
lib/ |
库目录 |
msg_gen/ |
通用 |
srv_gen/ |
通用 |
msg/*Action.msg |
通用 |
msg/*ActionFeedback.msg |
通用 |
msg/*ActionGoal.msg |
通用 |
msg/*ActionResult.msg |
通用 |
msg/*Feedback.msg |
通用 |
msg/*Goal.msg |
通用 |
msg/*Result.msg |
通用 |
msg/_*.py |
通用 |
build_isolated/ |
通用 |
devel_isolated/ |
通用 |
由动态重新配置生成
| 模式 |
忽略的内容 |
*.cfgc |
由动态重新配置生成 |
/cfg/cpp/ |
由动态重新配置生成 |
/cfg/*.py |
由动态重新配置生成 |
忽略生成的文档
| 模式 |
忽略的内容 |
*.dox |
忽略生成的文档 |
*.wikidoc |
忽略生成的文档 |
.project |
Eclipse 项目文件 |
.cproject |
Eclipse C/C++ 项目 |
CMakeLists.txt.user |
CMake 用户设置 |
srv/_*.py |
忽略生成的文档 |
*.pcd |
忽略生成的文档 |
*.pyc |
忽略生成的文档 |
qtcreator-* |
忽略生成的文档 |
*.user |
用户特定设置 |
/planning/cfg |
忽略生成的文档 |
/planning/docs |
忽略生成的文档 |
/planning/src |
忽略生成的文档 |
*~ |
Emacs 备份文件 |
Catkin 自定义文件
| 模式 |
忽略的内容 |
CATKIN_IGNORE |
Catkin 自定义文件 |
如何将此 .gitignore 用于 ROS
- 复制上面的ROS规则,或者直接下载文件。
- 在 Git 仓库根目录创建名为 .gitignore 的文件,并将规则粘贴进去。
- 如果其中一些文件已被跟踪,请运行 git rm -r --cached . 然后再次提交 - Git 仅将忽略规则应用于未跟踪的文件。
- 提交 .gitignore 以便团队中的每个人都共享相同的规则。