c# - 为什么 C# XML 成员文档不像在 VB.NET 中那样是 "smart"？解决方法？

Question

当我从 VB.NET 迁移到 C# 时，我注意到的一件事是成员的 XML 文档在 C# 中不像在 VB.NET 中那样“智能”。一方面，当您引用其他内容时，它缺乏智能感知。例如，在下面的屏幕截图中，我尝试在文档中引用 String 的方法。使用 VB，我可以获得智能感知下拉菜单，而使用 C#，我没有。

其次，如果我更改参数的名称，它不会像在 VB.NET 中那样在 C# 中产生警告，指示文档不再匹配方法签名:

这特别“危险”，因为它会导致您的 API 文档不正确。

造成这些差异的原因是什么？ C# 以这种方式受到限制是否有充分的理由？还是我应该以不同的方式看待它或以不同的方式做某事？

Answer 1

您只是看到了 C# 和 VB.NET IDE 的副作用，这些 IDE 已由 Microsoft 内部非常不同的团队实现。小团队是任何软件公司的生存策略，微软也不异常(exception)。

这些努力背后有历史，早在 C# 出现之前，Visual Basic 就有强大的 IDE 支持。 VB.NET 团队当然在实现他们的方面有了一个良好的开端。这并不总是一个优势，他们还不得不使其与早期的 IDE 相似，以减轻他们之前的 VB 客户必须经历的采用冲击。 VB.NET 已经是一个非常重要的版本，它与早期的 VB 版本有很大的不同。在其他方面与您现在正在经历的没有什么不同。

而且他们最终有不同的目标。例如，在您的屏幕截图中非常明显，VB.NET IDE 具有带有“Common”和“All”选项卡的选项卡式窗口。这让 很多 的 VB.NET 程序员陷入了困境，从来没有弄清楚他们有时需要“全部”。 C# 没有，不是那种积极隐藏任何东西的语言。

我们无法帮助您掩盖这些差异，没有针对它们的设置。您可以在 user voice 提交功能请求但这在很大程度上可能是在浪费你的努力。之前更改 IntelliSense 的请求一直得到“谢谢，我们会在下一个版本中考虑它!”没有实现。

您会习惯的，所有 C# 程序员都习惯了。