我的第一次 Godot Engine 贡献（以及你如何开始）

Source: Dev.to

为什么我要写这篇文章

和许多开发者一样，我每天都在使用开源软件，但贡献总是让人感到畏惧——代码库庞大、文件成千上万、开发者经验丰富。最终，我完成了对 Godot Engine 的第一次真正贡献，本文将说明：

• 我贡献了什么
• 我是如何开始接触开源的
• 任何人都能遵循的基本工作流

这是我的 Pull Request：
https://github.com/godotengine/godot/pull/115729

我没有尝试添加一个大功能，而是专注于理解现有代码库并做一次小而有意义的改进。这帮助我学到了：

• 大型项目是如何组织代码的
• 真实开源项目中的审查是如何进行的
• 如何清晰地沟通改动

最大的教训： 你的第一次贡献不需要很大，只要是正确的即可。

开始使用 Godot 仓库

1. Fork 主仓库
   https://github.com/godotengine/godot

2. 克隆你的 Fork

   git clone https://github.com/YOUR_USERNAME/godot.git
   cd godot

3. 添加 upstream 远程仓库（保持你的 Fork 与原项目同步）

   git remote add upstream https://github.com/godotengine/godot.git

基本工作流

创建功能分支

git checkout -b my-fix

永远不要直接在 master 或 main 上进行更改。

构建并测试

在推送任何内容之前，确保项目能够正确构建。

提交你的更改

git add .
git commit -m "Fix: clear description of the change"

• 保持提交简洁，聚焦于单一目的。

推送并打开 Pull Request

git push origin my-fix

然后在 GitHub 上打开 Pull Request。在 PR 描述中，清晰说明：

• What（更改做了什么）
• Why（为什么需要这项更改）
• 你考虑的任何 edge cases（边缘情况）

审核流程

你的 Pull Request 将由维护者审阅。你可能会被要求：

• 更新或改进代码的某些部分
• 添加额外的测试或文档

这些请求是正常的，是开源协作的一部分。审查不是批评，而是学习和提升的机会。

我收获了什么

• 对大规模软件构建方式的洞察
• 阅读已有代码、修复真实问题、公开讨论改动的经验
• 对小而精致的贡献也能产生价值的信心

有用资源

• 官方贡献指南：https://contributing.godotengine.org/en/latest/organization/how_to_contribute.html

欢迎在评论区提问。