开发引言
这是一份面向 《缺氧》（Oxygen Not Included）Mod 开发的教程。
它不准备把所有理论一次讲完。更现实的目标是：先让你知道工具怎么装、源码怎么看、补丁怎么写，再沿着一条能实际跑通的路线，把建筑、配方、本地化、科技解锁和发布串起来。
编写初衷
我在做 ONI Mod 的时候踩过不少坑，后来发现很多问题其实会反复出现。 这套文档就是把这些经验整理出来，给后来的人少留一点弯路。
这份文档会讲什么
| 特性 | 说明 |
|---|---|
| 源码参考 | 尽量贴近 Assembly-CSharp.dll 的实际结构，而不是只讲抽象概念。 |
| 偏重实践 | 重点放在 Hook 点、Prefab 修改、Harmony 补丁和常见问题处理。 |
| 持续整理 | 游戏更新后，文档也会逐步补充和修正。 |
建议阅读顺序
- STEP 1 环境准备 * 先把开发环境、工具链和 Visual Studio 配好。
- STEP 2 基础机制 * 再理解 Harmony、游戏对象结构和常见补丁写法。
- STEP 3 完整开发路线 * 从第一个补丁开始，依次跑通建筑、配方、本地化和发布。
如果你想直接开始写代码，可以先看完整开发路线；如果还没有配置过环境，先从开发环境配置开始。
学习建议
Mod 开发需要一定的 C# 基础。 如果你是编程新手，建议先了解变量、类、继承、方法、ref、null 和 Lambda 这些基本概念。 把地基打稳一点，后面读补丁和源码会轻松很多。