VS2022 MAUI中MSBuild跨平台编译报错：预处理器指令失效求助

错误原因分析 #

你遇到的CS0117错误主要来自两个方面：

1. 预处理器指令语法错误 #

查看你提供的TestClass代码，Android平台条件块的结束指令写为# endif（带有多余空格），正确语法应为#endif（无空格）。这个语法错误会导致预处理器无法正确解析条件块，对应平台的方法无法被正常编译，最终触发“找不到方法定义”的错误。

2. MAUI多目标编译的上下文特性 #

MAUI采用多目标编译模型，每个平台的编译过程完全独立：

• 共享目录（非Platforms文件夹）下的代码在编译对应平台时，会自动启用该平台的预处理器符号（如WINDOWS、ANDROID）。
• Platforms文件夹下的代码仅会在对应平台的编译流程中被包含。

即使预处理器语法正确，IDE的静态代码分析可能会基于当前选中的平台做全局检查，导致跨平台代码出现错误提示（比如在Windows平台下查看Android平台代码时，会提示HelloAndroid不存在），但实际编译对应平台时是可以正常通过的。

正式解决方案 #

方案1：修复预处理器指令语法 #

将TestClass中Android条件块的# endif改为#endif，修正后的代码如下：

namespace MauiApp1;
public class TestClass
{
#if WINDOWS
    public static void HelloWindows()
    {
        Console.WriteLine("windows");
    }
#endif

#if ANDROID
    public static void HelloAndroid()
    {
        Console.WriteLine("android");
    }
#endif
}

修正后，每个平台编译时会正确识别对应条件块的方法，编译错误会消失。

方案2：使用平台特定分部类（官方推荐） #

这是MAUI官方推荐的平台特定代码组织方式，既符合项目结构规范，又能避免静态分析工具的警告：

1. 在项目根目录创建TestClass的基类：

namespace MauiApp1;
public partial class TestClass
{
    // 此处放置跨平台共享代码
}

2. 在Platforms\Windows文件夹下创建TestClass的分部类：

namespace MauiApp1;
public partial class TestClass
{
    public static void HelloWindows()
    {
        Console.WriteLine("windows");
    }
}

3. 在Platforms\Android文件夹下创建TestClass的分部类：

namespace MauiApp1;
public partial class TestClass
{
    public static void HelloAndroid()
    {
        Console.WriteLine("android");
    }
}

关于静态分析工具警告的说明

MAUI官方允许Platforms目录下的类使用与根目录一致的命名空间，这是平台特定代码的标准写法。如果静态分析工具提示“命名空间与位置不匹配”，可以通过配置.editorconfig文件忽略该警告，例如添加：

dotnet_diagnostic.CA1707.severity = none

（具体规则编号需根据你使用的静态分析工具调整）

总结 #

优先选择分部类方案，这是MAUI设计时推荐的平台特定代码组织方式，能避免预处理器指令带来的语法风险和IDE分析歧义。如果坚持使用预处理器指令，务必确保语法完全正确，并理解多目标编译的上下文特性。

内容的提问来源于stack exchange，提问作者Irwene