⬅ 返回

⚡ C# 核心语法

---

这不是一篇“C# 入门”，而是 专门为《缺氧（ONI）》Mod 开发提炼的最小语法集。

🎯 阅读目标：

• 能直接看懂 ONI 源码
• 能独立写 Harmony Patch
• 知道哪些语法是“必须会”，哪些可以先无视

---

🧠 总览

ONI Mod 的 C# 本质只有四件事：

1️⃣ 类 + 组件 2️⃣ static + ref 3️⃣ 数组 + 泛型 4️⃣ null 判断

下面所有内容，都是在为这四点服务。

---

🧱 一、class 是一切的起点

你在 ONI 里只会写这三种类

public class XXXConfig : IBuildingConfig {}
public class XXXPatch {}
public class XXXComponent : KMonoBehaviour {}

结论：

• 类必须是 public
• 不要纠结面向对象

---

🔧 二、static：为什么 Patch 必须是 static

普通方法（ONI 几乎不用）

public void DoSomething() {}

Patch 方法（必须这样）

public static void Postfix() {}

原因一句话解释：

Harmony 不会 new 你的类，只能调用静态方法。

👉 Patch 写错 90% 都是这里的问题

---

🧬 三、ref：为什么 ONI Patch 能“改游戏”

没有 ref（改不到）

public static void Postfix(BuildingDef def)
{
    def.EnergyConsumptionWhenActive = 1f; // ❌ 无效
}

有 ref（直接改内存）

public static void Postfix(ref BuildingDef __result)
{
    __result.EnergyConsumptionWhenActive = 1f; // ✅ 生效
}

一句话结论：

Harmony 能改游戏，全靠 ref。

---

📦 四、组件思维：ONI ≈ Unity

所有功能 = 组件

go.AddOrGet<ElementConverter>();
go.AddOrGet<Operational>();

AddOrGet 的真实含义

有 → 拿
无 → 加

❗ ONI 世界里

• 没有组件 = 没有功能

---

🔍 五、泛型 <T>：不要怕，它只是“占位”

看到下面这两行，直接翻译成中文

go.AddOrGet<ElementConverter>();
go.GetComponent<KPrefabID>();

翻译：

“我要 ElementConverter 这个组件”

<T> = 类型占位符，仅此而已

---

🚧 六、null 判断：ONI Mod 的生命线

正确写法

var converter = go.GetComponent<ElementConverter>();
if (converter == null)
    return;

原因一句话：

Patch 执行顺序不固定，组件不一定存在。

👉 不写 null 判断 = 随机崩溃

---