Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
学习新特性¶
Godot 是一个功能丰富的游戏引擎。有很多东西可以学习。本页面将介绍如何使用在线手册、内置代码参考、参与在线社区，从而学习新特性、新技术。
充分利用本手册¶
你正在阅读的是用户手册，讲解的是引擎中用到的概念和提供的功能。学习新的专题时，你可以先浏览本网站上的对应章节。你可以使用左侧菜单查看专题，也可以借助搜索栏找到特定的页面。如果存在与主题对应的页面，里面通常还会链接到其他相关内容。
本手册附有类的参考部分，解释每个 Godot 类的可用功能和属性。手册部分涵盖了常用的功能、概念以及如何使用编辑器等内容，参考部分主要介绍如何使用 Godot 的脚本API（应用程序编程接口），可以在线和离线访问，建议在 Godot 编辑器中通过帮助 -> 搜索或按 F1 离线浏览。
要在线浏览，请转到手册的 Class Reference 部分。
类参考手册页面会展示：
这个类在继承结构中的位置。你可以点击顶部的链接跳转到父类，查看某个类型所继承的属性和方法。
这个类的角色与使用概要。
这个类的属性、方法、信号、枚举、场景的解释。
深入介绍这个类的手册页面的链接。
备注
如果手册或类参考文献缺失或信息不足，请在官方 GitHub仓库 godot-docs 中提交 Issue 来报告它。
You can hold Ctrl (macOS Cmd) and then mouseover text like the name of a class, property, method, signal, or constant to underline it, then Ctrl + Click (macOS Cmd + Click) it to jump to it.
学会像程序员一样思考¶
传授程序基础和编程员思维已经超出Godot文档的范围。如果你刚开始编程，我们建议阅读以下两个优秀的免费教程开始：
哈佛大学提供了一个免费的课件来学习编程， CS50 。他将教你程序基础、代码是如何运行的以及如何拥有编程思维。这些技能是你成为游戏开发者和有效学习任何游戏引擎的基础。你可以将学习这门课程看作是一项投资，他将减少你在学习游戏开发过程中的时间和麻烦。
如果你更喜欢阅读书籍，免费电子书 Automate The Boring Stuff With Python Al Sweigart著。
与社区共同学习¶
Godot 的用户社区在不断地增长。如果你遇到问题或需要帮助以更好地理解如何实现某件事情，你可以在许多活跃社区中向其他用户寻求帮助。
提出问题并找到已经回答的问题的最佳地点是官方的问答网站。这些回答会显示在搜索引擎结果中，并被保存起来，使其他用户能够从该平台的讨论中受益。一旦你在那里提出问题，你可以在其他社交平台上分享其链接。在提出问题之前，一定要在这个网站上或使用你喜欢的搜索引擎寻找可能解决你问题的现有答案。
善于提问并提供细节会帮助别人更快更好地回答你。在提出问题时，我们建议包括以下信息：
描述你的目标。你要解释你在设计上想要达到什么目的。如果你在弄清楚如何使解决方案发挥作用时遇到困难，那么可能会有不同的、更简单的解决方案来实现相同的目标。
如果涉及到报错，请分享确切的报错信息。你可以在编辑器的调试器底部面板上点击复制错误图标来复制确切的错误信息。了解它的内容可以帮助社区成员更好地识别你是如何触发错误的。
如果涉及代码，分享代码示例。其他用户在没有看到你的代码的情况下将无法帮助你解决问题。直接以文本形式分享代码。为此，你可以将一段简短的代码片段复制并粘贴到聊天框中，或使用 Pastebin 之类的网站来共享长文件。
分享你的“场景”面板的截图 ，以及你写的代码。你写的大部分代码都会影响你的场景中的节点。因此，你应该把这些场景看成是你的源代码的一部分。
Also, please don't take a picture with your phone, the low quality and screen reflections can make it hard to understand the image. Your operating system should have a built-in tool to take screenshots with the PrtSc (Print Screen) key (macOS: use Cmd + Shift + 3 for a full screen shot, more information here).
Alternatively, you can use a program like ShareX on Windows, or FlameShot on Linux.
分享你的游戏录像对发现游戏中的问题同样是很有用的。你可以使用 OBS 或者 Screen to GIF 来捕获你的屏幕。
然后你可以使用像 streamable 或云服务提供商的服务，免费上传和分享你的视频。
如果你在使用非稳定版本的 Godot，请说明你正在使用的版本。由于非稳定版 Godot 的可用功能和接口会快速迭代，你所得到的答案可能大不相同。
遵循这些规范可以最大化你找到所需答案的机会。既节省你的时间，也节省帮助你的人的时间。
社区教程¶
本手册旨在提供一个全面的功能参考以便查阅。除了 2D 和 3D 游戏的入门教程系列外，本手册不包含实现具体某种游戏的教程。如果你需要关于 RPG 游戏、平台跳跃游戏或者其他类型游戏的创作教程，请参见 教程和资源，这里面包含了 Godot 社区所制作的内容。