分部类允许将一个类拆分到多个文件中，编译时合并为一个整体。1. 用于代码生成器与手动代码分离，避免生成代码覆盖问题；2. 拆分大型类，按功能组织文件提升可维护性；3. 多平台项目中按条件实现部分成员。所有部分需在同一程序集、使用partial关键字、不能重复定义成员，且访问修饰符和继承信息在合并时统一处理。该机制不改变运行行为，仅为编译期组织手段。
分部类（partial class）是 C# 中一种将一个类的定义拆分到多个文件中的机制。通过使用 partial 关键字，可以在不同的 .cs 文件中编写同一个类的部分成员，编译时这些部分会被合并成一个完整的类。
分部类的基本语法
例如，可以这样定义一个分部类：File1.cs
public partial class MyClass
{
public void MethodOne()
{
Console.WriteLine("Method One");
}
}
File2.cs
public partial class MyClass
{
public void MethodTwo()
{
Console.WriteLine("Method Two");
}
}
在编译后，MyClass 会包含 MethodOne 和 MethodTwo 两个方法，就像它们写在一个文件里一样。
partial关键字的使用场景
1. 代码生成工具配合手动编码
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
解决方案：工具生成的类标记为 partial，你另建一个同名 partial 类文件来写扩展逻辑。这样既能保留自动生成的代码，又能安全地添加自己的方法或属性。
2. 大型类的逻辑分离
当一个类非常庞大，包含大量方法时，可以把相关功能的方法分组放到不同文件中，提升可维护性。比如：
- MyService.cs – 主类定义
- MyService.Validation.cs – 验证相关方法
- MyService.Logging.cs – 日志处理方法
3. 支持跨平台或多项目共享
在某些多目标项目（如 .NET Standard + 平台特定实现）中，可以用 partial 类根据不同平台提供不同部分的实现。虽然这种场景较少，但在高级库开发中有一定应用。使用 partial 的限制和注意事项
尽管 partial 很有用，但需注意以下几点：- 所有 partial 声明必须都在同一程序集中（不能跨 DLL）
- 所有部分都必须使用 partial 关键字
- 访问修饰符以实际声明为准，合并时不冲突即可
- 不能在一个文件中定义两次相同成员
- 各部分可以有不同的基类或接口，最终类会合并所有继承信息（但主类只能有一个基类）
基本上就这些。partial 不改变运行行为，只是编译期的代码组织手段。它让代码更清晰，也解决了自动生成代码与手动代码共存的问题。用好它，能让项目结构更合理，维护更方便。
