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 备份文件

Emacs

模式 忽略的内容
.#* Emacs

Catkin 自定义文件

模式 忽略的内容
CATKIN_IGNORE Catkin 自定义文件

如何将此 .gitignore 用于 ROS

  1. 复制上面的ROS规则,或者直接下载文件。
  2. 在 Git 仓库根目录创建名为 .gitignore 的文件,并将规则粘贴进去。
  3. 如果其中一些文件已被跟踪,请运行 git rm -r --cached . 然后再次提交 - Git 仅将忽略规则应用于未跟踪的文件。
  4. 提交 .gitignore 以便团队中的每个人都共享相同的规则。

其他 框架 .gitignore 模板

查看每个 框架 模板