为什么ASP.NET Core没有英文对应的简体中文注释？

[gallop1]

Is there an existing issue for this?

• I have searched the existing issues

Is your feature request related to a problem? Please describe the problem.

Describe the solution you'd like

能否提供一个所有.NET Core版本的所有ASP.NET Core的简体中文注释，包括EF Core也提供一份中文简体注释了？

Additional context

[martincostello]

To my knowledge, /// comments have never been provided in any language other than US English for the entire of .NET. Localisation is only done at the tooling level (Visual Studio) and at runtime (exception messages).

I think this is a bigger ask than just ASP.NET Core.

[gallop1]

我问过Visual Studio团队了，他叫我去问ASP. NET Core团队，所以你的回答叫我问回VS团队我很奇怪，这个中文化本地化没有办法解决吗？为什么. NET Framework 却没有这个问题，有中文注释提醒了？不都是框架吗？只是不同的两个框架而已啊。 | | 朱向驰 18818474780 ***@***.*** 广东省清远市佛冈县 | ---- 回复的原邮件 ---- | 发件人 | Martin ***@***.***> | | 发送日期 | 2025年04月10日 16:34 | | 收件人 | dotnet/aspnetcore ***@***.***> | | 抄送人 | zhuxiangchi ***@***.***>, Author ***@***.***> | | 主题 | Re: [dotnet/aspnetcore] 为什么ASP.NET Core没有英文对应的简体中文注释？ (Issue #61423) | To my knowledge, /// comments have never been provided in any language other than US English for the entire of .NET. Localisation is only done at the tooling level (Visual Studio) and at runtime (exception messages). I think this is a bigger ask than just ASP.NET Core. — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: ***@***.***> martincostello left a comment (dotnet/aspnetcore#61423) To my knowledge, /// comments have never been provided in any language other than US English for the entire of .NET. Localisation is only done at the tooling level (Visual Studio) and at runtime (exception messages). I think this is a bigger ask than just ASP.NET Core. — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: ***@***.***>

[martincostello]

I didn't ask you to ask anyone anything, I just said that localizing everything with respect to /// comments to the same degree as tools such as Visual Studio is a very big piece of work that's bigger than just ASP.NET Core.

For example using this code in dotnet/sdk as a basis, localisation is done for 13 different languages/cultures. You can see how big the effort (and cost) is going to add up of translating everything in the XML documentation across all the libraries and APIs (right now there are 1,742,134 APIs across the surface area of .NET).

[dyyhf123]

Before .net6 we can download the localized .NET IntelliSense files from this page - Download localized .NET IntelliSense files. But long after .net6 was released. This page did not add the localized .NET IntelliSense files for .net6. According to this dotnet/docs#27283 in dotnet/docs there is no localized .NET IntelliSense files any more - "Yes, unfortunately, we will no longer be localizing IntelliSense.". But the online docs has the localized descriptions. So this tool was born.

IntelliSenseLocalizer use the online docs to generate Localized IntelliSense files. This tool will download all api pages and analysis the content to match the origin IntelliSense file content and generate the target xml.

Benefit from online docs's nice localization and uniform page layout. This tool can theoretically generate all locale's file. But when the page layout change this tool cannot automatically adapt to the new layout.

在NET5.0及以前，确实官方提供过本地化语言的注释文件，但是net6.0之后就没有了。
你或许可以试试这个项目，可以帮助在visual studio 中实现IntelliSense的本地化。
https://github.com/stratosblue/IntelliSenseLocalizer

[gallop1]

@dyyhf123 你好，你这个我使用islocalizer build -m net9.0，全部生成成功之后为什么却在C:\Program Files\dotnet\packs\Microsoft.AspNetCore.App.Ref\9.0.4\ref\net9.0\文件夹下面找不到zh-cn对应翻译过来的xml文件。islocalizer build -m net6.0的就可以了,再次向你确认一下，调用这个命令之后，是不是就在对应类库文件夹默认下面创建zh-cn文件夹翻译成对应的中文xml文件了？期待你尽快回复我。谢谢先了。 ***@***.*** 发件人： dyyhf123 发送时间： 2025-04-13 11:16 收件人： dotnet/aspnetcore 抄送： zhuxiangchi; Author 主题： Re: [dotnet/aspnetcore] 为什么ASP.NET Core没有英文对应的简体中文注释？ (Issue #61423) 你或许可以试试这个项目，可以帮助在visual studio 中实现本地化。 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: ***@***.***> dyyhf123 left a comment (dotnet/aspnetcore#61423) 你或许可以试试这个项目，可以帮助在visual studio 中实现本地化。 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you authored the thread.Message ID: ***@***.***>