如何正确使用MVVM RelayCommand特性？排查CS0616编译错误

问题描述 #

使用Community Toolkit的RelayCommand特性时触发CS0616编译错误，提示'RelayCommand'不是特性类，编写的示例代码如下：

using CommunityToolkit.Mvvm.ComponentModel;
using CommunityToolkit.Mvvm.Input;

namespace HelloWorld_WinUI3.ViewModels;

public partial class MainViewModel : ObservableObject
{
    public MainViewModel()
    {
    }

    private int _counter = 0;

    [RelayCommand]
    private async Task DoSomethingAsync()
    {
        await Task.Delay(1000);
        MyString = $"Hello {_counter++}";
    }

    [ObservableProperty]
    private string _myString = "Hello"; 
}

错误原因 #

这个错误的核心是引用的NuGet包版本不兼容：

• 在CommunityToolkit.Mvvm 8.0版本之前，RelayCommand只是一个普通的命令实现类，并非特性；
• 从8.0版本开始，官方引入了基于源生成器的MVVM工具，才新增了[RelayCommand]特性，用于自动生成命令属性。

如果项目安装的是8.0之前的版本，编译器就会识别不到RelayCommand作为特性的定义，从而抛出CS0616错误。

正确使用方法 #

1. 更新NuGet包版本
   打开项目的NuGet包管理器，找到CommunityToolkit.Mvvm，将其更新到8.0.0及以上版本。

2. 保持代码结构正确性
   你的示例代码结构本身符合要求：

   • ViewModel类必须标记为partial（源生成器需要生成部分类代码）；
   • 继承ObservableObject以支持属性变更通知；
   • 给异步/同步方法添加[RelayCommand]特性后，源生成器会自动生成对应的命令属性（比如示例中的DoSomethingAsync会生成DoSomethingCommand属性）。

3. 验证效果
   包版本更新后编译错误会消失，你可以直接在视图中绑定自动生成的DoSomethingCommand属性，无需手动创建RelayCommand实例。

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