C# Organize Usings 1.1.0

新的介绍内容：

C# Organize Usings：优化Visual Studio Code中的C# using语句

C# Organize Usings扩展旨在为Visual Studio Code用户提供高效的C# using语句管理功能，复制并增强了Visual Studio中的排序和清理行为。此扩展是对已弃用的CSharpFormatUsings扩展的活跃支持和分支版本，提供了错误修复、新功能以及与OmniSharp、Roslyn和C# Dev Kit语言服务器的兼容性。

主要功能：

• 清理冗余： 默认启用（可禁用）的功能，自动移除不必要和重复的using指令。
• 智能排序： 将using指令按字母顺序排序，并根据命名空间的第一级进行分组。
• 多种触发方式： 可在保存时自动触发，也可以通过编辑器右键菜单或命令面板中的“Organize C# Usings”命令手动触发，支持设置为键盘快捷方式。
• 自定义间隔： 在排序后的using语句集之间插入可配置数量的空行。
• 灵活设置： 提供多种可配置设置，用于格式化using部分（详见“扩展设置”）。

版本历史：

• 1.1.0：支持using块中的预处理指令（问题#21），重新设计了查找using语句块的正则表达式，以更好处理空行和注释，将移除未使用using的设置调整为以禁用为中心，退役numEmptyLinesAfterUsings和numEmptyLinesBeforeUsings设置，对排序和分组进行了轻微重构。这是我们的首个“预发布”版本，采用微软建议的编号方案（“因此，我们建议扩展使用major.EVEN_NUMBER.patch作为发布版本，使用major.ODD_NUMBER.patch作为预发布版本”）。
• 1.0.6：修复了首次执行“Organize C# Usings”命令时无法移除所有未使用using的错误。vs.languages.getDiagnostics返回的行号被误解。增加了关于移除未使用using的单元测试。
• 1.0.5：增加了保存时原生运行的支持，改进了清理过程中移除重复项的处理，添加了调试输出面板通道，以及源代码的各种改进。
• 1.0.4：处理来自Roslyn的未使用using的IDE0005诊断，使得在禁用OmniSharp时与C#扩展兼容。
• 1.0.3：正确处理别名using指令，不会破坏语法如using [type] [variableName] = whatever。添加了基本的单元测试覆盖。
• 1.0.2：根据微软的建议，使用TextEditorEdit.delete/insert替代replace，修复了编辑器跳跃问题。
• 1.0.1：修复了在不需要更改的文件上运行“Organize Usings”时编辑器跳跃的问题。
• 1.0.0：当类的所有using都是不必要时，正确移除未使用using，并解决了命名空间组之间额外空行导致的问题。

扩展设置：

• sortOrder：设置命名空间的排序顺序。值应以空格分隔，默认为“System”。
• splitGroups：在根据命名空间第一部分分组的using块之间插入空行，默认启用。
• disableUnusedUsingsRemoval：禁用移除未使用using的功能（默认启用），默认值为false。
• processUsingsInPreprocessorDirectives：启用时，将移除预处理指令内的未使用using，默认值为false。

保存时执行：

要在保存C#文件时自动组织，请在您的settings.json文件中添加以下内容：

"[csharp]": { "editor.codeActionsOnSave": ["source.organizeImports"] }

从源代码安装：

1. 安装node.js。
2. 在项目文件夹中运行npm install。
3. 在项目文件夹中运行vsce package。请确保已安装vsce：npm install -g vsce。
4. 通过vscode插件菜单选项“从VSIX安装”安装全新的*.vsix包。

历史：

2024年从CSharpFormatUsings（一个于2020年8月22日最后修改的已弃用扩展）分支而来，该扩展本身是从CSharpSortUsings分支的，而CSharpSortUsings又是从CSharpFixFormat分支的。