MAUI类库中分部方法（Partial Method）编译报错问题咨询

我刚花了5分钟按照你的步骤创建了MAUI类库和测试App，确实复现了完全一样的编译错误，咱们一步步拆解问题的根源和解决办法：

先看两个错误对应的核心原因 #

1. 错误CS8795：带访问修饰符的分部方法必须有实现

这是C#语言本身的硬规则：如果分部方法加了internal、public这类访问修饰符，它就不再是“可选实现”的分部方法了，必须要有明确的实现部分。

看你的ReadData方法：

• 共享代码里的ReadData是带internal修饰符的空声明（没有方法体）
• 平台代码里的ReadData是带internal修饰符的实现（有方法体）

虽然你看似写了实现，但MAUI类库是多目标编译项目，编译器会在统一的上下文里检查规则：它看到共享代码里的ReadData有访问修饰符但没有实现，直接触发这个错误——而MAUI App因为是单平台编译，能看到完整的实现，所以跳过了这个严格检查。

2. 错误CS0759：分部方法的“定义”和“实现”搞反了

C#分部方法的规则要求：必须有一个定义部分（仅声明签名，无方法体）和一个实现部分（带方法体），而且定义部分必须是隐式private的（不能加任何访问修饰符）。

你的WriteData方法正好搞反了：

• 共享代码里的WriteData是带internal修饰符的实现（有方法体）
• 平台代码里的WriteData是带internal修饰符的空声明（无方法体）

编译器会把共享代码里带实现的WriteData当成“实现部分”，但找不到符合规则的“定义部分”（无访问修饰符的空声明），所以报错说找不到对应的定义。

为什么MAUI App里能正常运行？ #

MAUI App在编译特定平台（比如Android）时，只会加载对应平台的代码文件，共享代码和当前平台的代码会被合并成一个完整的类编译，编译器能看到两个方法的完整实现，所以没有触发规则检查。但MAUI类库是多目标编译，要同时兼容所有平台的编译规则，所以会严格执行C#分部方法的所有约束。

解决办法 #

根据你的需求，推荐两种可行的替代方案：

方案1：去掉访问修饰符，改用隐式private的分部方法

如果这些方法只需要在Connector类内部调用，可以把internal修饰符删掉，回到传统分部方法的规则：

// 共享代码的Connector类
public partial class Connector
{
    // 定义部分：无访问修饰符，仅签名
    partial void ReadData(string command, Action<string, string> readCallback);
    
    // 实现部分：带方法体
    partial void WriteData(string command, Action<string, string> readCallback)
    {
        // 共享代码的WriteData逻辑
    }
}

// 平台代码的Connector类
public partial class Connector
{
    // 实现部分：带方法体
    partial void ReadData(string command, Action<string, string> readCallback)
    {
        // 平台特定的ReadData逻辑
    }
    
    // 定义部分：无访问修饰符，仅签名
    partial void WriteData(string command, Action<string, string> readCallback);
}

这种写法完全符合C#规则，MAUI类库编译不会报错，但缺点是这些方法只能在类内部调用，无法对外暴露。

方案2：改用MAUI官方推荐的跨平台实现方式（更推荐）

如果你的方法需要对外暴露（所以需要internal/public权限），建议放弃分部方法，改用抽象类+平台实现的标准模式：

// 共享代码：定义抽象基类
public abstract class Connector
{
    // 对外暴露的公共方法
    public void ExecuteRead(string command, Action<string, string> callback)
    {
        ReadData(command, callback);
    }

    public void ExecuteWrite(string command, Action<string, string> callback)
    {
        WriteData(command, callback);
    }

    // 平台需要实现的抽象方法
    protected abstract void ReadData(string command, Action<string, string> readCallback);
    protected abstract void WriteData(string command, Action<string, string> readCallback);
}

// 平台代码（比如Android）：实现抽象类
public class AndroidConnector : Connector
{
    protected override void ReadData(string command, Action<string, string> readCallback)
    {
        // Android平台的ReadData逻辑
    }

    protected override void WriteData(string command, Action<string, string> readCallback)
    {
        // Android平台的WriteData逻辑
    }
}

然后通过MAUI的依赖注入注册平台实现：

// 在Platforms/Android/Program.cs中注册
builder.Services.AddSingleton<Connector, AndroidConnector>();

// 在共享代码中使用
var connector = ServiceProvider.GetRequiredService<Connector>();
connector.ExecuteRead("test", (result, error) => { ... });

这种方式是MAUI跨平台开发的标准实践，没有分部方法的规则限制，代码也更清晰易维护。

为什么不推荐在跨平台类库中用分部方法？ #

正如你遇到的问题，分部方法的规则非常苛刻，尤其是带访问修饰符的场景，很容易触发编译错误。而且跨平台类库的多目标编译会放大这些问题——MAUI类库需要兼容多个平台的编译上下文，分部方法的隐式行为很容易导致不可预测的问题，这就是很多文章不推荐的核心原因。

备注：内容来源于stack exchange，提问作者slash shogdhe