.NET MAUI中[RelayCommand]方法名小写为何编译失败？

结论：[RelayCommand]特性要求标记的方法名首字母必须为大写（大驼峰/PascalCase格式），这是官方明确的源代码生成规则

错误场景复现 #

你最初的实现代码：
XAML绑定：

<Button 
   Text="Add"
   Command="{Binding data_addCommand}"
   />

ViewModel方法：

[RelayCommand]
private void data_add()
{

}

此时编译触发CS0102错误：The type '[my_viewmodel_name]' already contains a definition for 'data_addCommand'

错误原因分析 #

这个错误本质是因为当方法名以小写开头时，CommunityToolkit.Mvvm的源代码生成器在命名处理时出现冲突：

• 生成器会尝试基于原方法名data_add生成data_addCommand命令属性
• 同时，内部的命名规范转换逻辑会自动将小写开头的方法名转换为大驼峰格式，尝试生成Data_addCommand
• 两个命名冲突，导致编译报错

官方规则说明 #

CommunityToolkit.Mvvm的源代码生成器（涵盖[RelayCommand]、[ObservableProperty]等特性）严格遵循.NET代码命名规范：

• 被[RelayCommand]标记的方法必须使用**大驼峰（PascalCase）**命名（首字母大写）
• 生成器会基于该方法名自动添加Command后缀，生成对应的命令属性（同样为大驼峰格式）
• 这一规则和[ObservableProperty]生成大驼峰属性的逻辑完全一致，目的是匹配.NET MAUI/WPF等UI框架中数据绑定的命名惯例

验证解决方法 #

当你修改首字母为大写后：
XAML绑定：

<Button 
   Text="Add"
   Command="{Binding Data_addCommand}"
   />

ViewModel方法：

[RelayCommand]
private void Data_add()
{

}

生成器会正确生成唯一的Data_addCommand命令属性，XAML绑定与属性名完全匹配，因此编译通过。

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