partial关键字允许将类、结构、接口或方法拆分到多个文件中，编译时自动合并，适用于大型项目和代码生成场景。
在C#中，partial 关键字允许你将一个类、结构、接口或方法的定义拆分到多个文件中。编译时，这些部分会被合并成一个完整的类型。这在大型项目或代码生成场景中特别有用，比如 Windows Forms、WPF 或 Entity Framework 中，设计器文件和用户代码可以分开管理。
partial 类的作用
使用 partial class 可以把一个类的成员分布在多个 .cs 文件中。每个文件都使用 partial 修饰类名，编译器会在编译时将它们组合起来。
例如，有一个类 Person，你可以将属性定义在一个文件中，方法定义在另一个文件中：
// Person.Name.cs
public partial class Person
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
{
public string FirstName { get; set; }
public string LastName { get; set; }
}
// Person.Methods.cs
public partial class Person
{
public string GetFullName()
{
return $"{FirstName} {LastName}";
}
}
编译后，Person 类就同时拥有属性和方法，就像它们写在一个文件里一样。
partial 方法的使用
partial method 只能在 partial class 中定义，且只能声明在其中一个部分中，实现可选。如果没有任何部分提供实现，编译器会自动移除该调用，不会报错。
这常用于代码生成工具：生成的代码中声明一个 partial 方法，开发者可在另一个部分中选择性地实现它。
// 自动生成的文件（Person.Generated.cs）
public partial class Person
{
partial void OnNameChanged(); // 声明
public string Name
{
get => _name;
set
{
_name = value;
OnNameChanged(); // 调用，若无实现则被移除
}
}
}
// 开发者文件（Person.Custom.cs）
public partial class Person
{
partial void OnNameChanged()
{
Console.WriteLine("Name was changed!");
}
}
如果没有在任何部分实现 OnNameChanged，调用会被忽略，不产生运行时开销。
拆分类定义的注意事项
- 所有部分必须使用 partial 关键字
- 所有部分必须在同一程序集中（不能跨 assembly）
- 访问修饰符以实际定义为准，但通常建议保持一致
- 泛型参数、基类等可以在任意部分声明，最终会合并
- 不能重复定义同一个成员（如两个同名属性）
基本上就这些。合理使用 partial 类可以让代码更清晰，特别是在自动生成代码与手动编写代码共存的场景下。
