编写C#扩展方法时如何约定TKey、TValue已正确实现ToString()？

1. 有没有内置特性/约定可以强制TKey、TValue正确实现ToString() #

没有。所有.NET类型都默认继承自object基类，默认自带ToString()方法，不管是否被重写，所以你无法通过泛型约束来限定泛型参数必须重写ToString()，也没有官方内置的特性可以标记这个要求。
你可以自定义特性配合Roslyn分析器实现编译期检查，但这类实现不属于通用约定，其他开发者使用你的方法时需要额外安装对应的分析器，落地成本很高。

2. 是否只需要在方法摘要中注明前提即可 #

是，这是.NET生态的通用做法。你可以直接在XML注释中明确标注前提，示例如下：

/// <summary>
/// 将键值对集合转换为易读格式的字符串
/// </summary>
/// <typeparam name="TKey">键的类型</typeparam>
/// <typeparam name="TValue">值的类型</typeparam>
/// <param name="list">待转换的键值对集合</param>
/// <returns>格式化后的字符串，格式为 [键1] - [值1]; [键2] - [值2]; </returns>
/// <remarks>
/// 本方法依赖 <typeparamref name="TKey"/> 和 <typeparamref name="TValue"/> 对 <see cref="object.ToString()"/> 的重写实现来生成可读性良好的输出。
/// 若对应类型未重写 <see cref="object.ToString()"/>，将默认返回类型的完全限定名。
/// </remarks>
public static string ToPrettyString<TKey, TValue>(this IEnumerable<KeyValuePair<TKey, TValue>> list)

3. 这类扩展方法是否不建议编写 #

完全可以编写，属于非常实用的工具类方法，但是你的现有实现可以做几个优化点：

• 增加null校验：当前实现如果入参list为null，遍历的时候会直接抛出空引用异常，建议提前校验抛出规范的ArgumentNullException
• 修正末尾多余分隔符：当前实现所有元素拼接完后末尾会多出一个; ，可以改用string.Join来简化实现自动处理分隔符，性能和可读性都更好：

  public static string ToPrettyString<TKey, TValue>(this IEnumerable<KeyValuePair<TKey, TValue>> list)
  {
      if (list == null) throw new ArgumentNullException(nameof(list));
      return string.Join("; ", list.Select(item => $"{item.Key} - {item.Value}"));
  }
  

• 可增加重载支持自定义配置：比如允许传入自定义的键值分隔符、元素分隔符、格式化提供器等，适配更多场景。

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