为何Console.WriteLine未调用重载ToString却触发double隐式转换？

最小可复现代码 #

// 隐式和显式转换是可重载的运算符：

Note note = new Note(9);
Console.WriteLine(note);

Note n = (Note)554.37;
double x = n;
Console.WriteLine(n);
Console.WriteLine(x);

public struct Note
{
    int value;
    public int SemitonesFromA { get { return value; } }

    public Note(int semitonesFromA) { value = semitonesFromA; }

    // 转换为赫兹
    public static implicit operator double(Note x) => 440 * Math.Pow(2, (double)x.value / 12);

    // 从赫兹转换（精确到最近的半音）
    public static explicit operator Note(double x) =>
        new Note((int)(0.5 + 12 * (Math.Log(x / 440) / Math.Log(2)))); 
    
    public override string ToString() => $"{SemitonesFromA} semitones from A";
}

预期输出 #

9 semitones from A
4 semitones from A
554.3652619537442

实际输出 #

739.9888454232688
554.3652619537442
554.3652619537442

疑问与解答 #

问题原因 #

你的推测正确：Console.WriteLine的重载决议中，自定义类型到double的隐式转换优先级高于装箱到object的转换，因此编译器会优先选择接受double的重载，而非接受object的重载（后者才会调用你重写的ToString()方法）。

重载决议机制细节 #

C#编译器选择方法重载时，会按转换代价从低到高的优先级筛选可行重载：

1. 优先匹配类型完全一致的重载（身份转换）
2. 其次是内置隐式数值转换（比如int转long）
3. 然后是用户定义的隐式转换（即你实现的implicit operator double(Note x)）
4. 再之后是装箱转换（值类型转object/接口类型，这里Note是值类型，转object属于装箱）
5. 最后是拆箱转换（object转值类型）

你的代码中，调用Console.WriteLine(note)时存在两个可行重载：

• Console.WriteLine(object)：需要将Note装箱为object
• Console.WriteLine(double)：需要通过自定义隐式转换把Note转成double

由于用户定义的隐式转换优先级高于装箱转换，编译器会选择后者，直接输出转换后的赫兹数值，而非调用ToString()。

如何通过官方文档判断重载选择 #

官方C#文档明确了重载决议的核心规则与转换优先级：

• 先筛选所有可行重载（实参可通过隐式转换匹配形参的重载）
• 编译器为每个可行重载计算“转换等级”，等级越低（代价越小）越优先
• 用户定义的隐式转换等级高于装箱/拆箱转换，因此会被优先选中

如果要强制触发ToString()调用，可通过两种方式：

1. 显式调用ToString()：Console.WriteLine(note.ToString())
2. 强制将实例装箱为object：Console.WriteLine((object)note)

内容的提问来源于stack exchange，提问作者FluidMechanics Potential Flows