AvaloniaUI中Command Guards（命令守卫）未触发问题求助

问题场景 #

在Visual Studio创建的AvaloniaUI测试项目中，按钮绑定的Click命令可正常执行并接收参数，但对应的命令守卫方法CanClick从未被调用，按钮始终处于可点击状态。

相关代码 #

MainWindowViewModel.cs

using System.Threading.Tasks;

namespace AvaloniaApplication1.ViewModels
{
    public class MainWindowViewModel : ViewModelBase
    {
        public bool CanClick(string s)
        {
            return false;
        }

        public async Task Click(string s)
        {
            await Task.CompletedTask;
        }
    }
}

MainWindow.axaml

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:vm="using:AvaloniaApplication1.ViewModels"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
        mc:Ignorable="d" d:DesignWidth="800" d:DesignHeight="450"
        x:Class="AvaloniaApplication1.Views.MainWindow"
        x:DataType="vm:MainWindowViewModel"
        Icon="/Assets/avalonia-logo.ico"
        Title="AvaloniaApplication1">

    <Design.DataContext>
        <!-- This only sets the DataContext for the previewer in an IDE,
             to set the actual DataContext for runtime, set the DataContext property in code (look at App.axaml.cs) -->
        <vm:MainWindowViewModel/>
    </Design.DataContext>

    <Button Command="{Binding Click}" CommandParameter="A">Click me!</Button>
</Window>

问题原因及解决方案 #

1. 检查ViewModel基类的INotifyPropertyChanged实现 #

Avalonia的命令守卫依赖属性变更通知机制，ViewModelBase必须正确实现INotifyPropertyChanged接口。若基类未实现或实现不完整，Avalonia无法检测CanClick的状态变化，也就不会调用该方法。

确认ViewModelBase代码类似如下：

using System.ComponentModel;
using System.Runtime.CompilerServices;

namespace AvaloniaApplication1.ViewModels
{
    public class ViewModelBase : INotifyPropertyChanged
    {
        public event PropertyChangedEventHandler? PropertyChanged;

        protected void OnPropertyChanged([CallerMemberName] string? propertyName = null)
        {
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
        }
    }
}

2. 启用编译时绑定 #

尽管XAML中已添加x:DataType="vm:MainWindowViewModel"，但需在项目文件（.csproj）中明确启用编译时绑定，否则Avalonia不会自动生成命令守卫的相关逻辑。

在项目文件中添加以下配置：

<PropertyGroup>
  <AvaloniaUseCompiledBindingsByDefault>true</AvaloniaUseCompiledBindingsByDefault>
</PropertyGroup>

3. 手动触发命令状态更新 #

若CanClick的返回值依赖ViewModel中的属性，当该属性变化时，需手动调用CommandManager.InvalidateRequerySuggested()触发命令守卫重新检查：

using System.Windows.Input;

public class MainWindowViewModel : ViewModelBase
{
    private string _checkProperty;

    public string CheckProperty
    {
        get => _checkProperty;
        set
        {
            _checkProperty = value;
            OnPropertyChanged();
            CommandManager.InvalidateRequerySuggested();
        }
    }

    public bool CanClick(string s)
    {
        return !string.IsNullOrEmpty(CheckProperty);
    }

    public async Task Click(string s)
    {
        await Task.CompletedTask;
    }
}

4. 验证命名规则 #

确保命令守卫方法严格遵循Can{CommandMethodName}的命名格式，大小写完全匹配。例如命令方法为Click，守卫方法必须是CanClick；命令方法为SaveAsync，守卫方法必须是CanSaveAsync。你的代码命名规则正确，但需排查拼写错误。

内容的提问来源于stack exchange，提问作者Starnuto di topo