在dotnet/docs项目中修正VB.NET单元测试模板语法错误

在.NET Core项目中使用Visual Basic语言创建单元测试时，开发人员需要注意命令行参数的格式问题。近期在dotnet/docs官方文档中发现了一个关于VB.NET单元测试模板语法的错误示例。

问题描述

文档中原本提供的命令示例使用了不正确的参数格式：

dotnet new classlib -o PrimeService --lang VB

这个命令会抛出错误，因为--lang并不是dotnet new命令的有效参数格式。正确的参数格式应该使用单横线-而非双横线--。

正确语法

经过验证，正确的命令格式应为：

dotnet new classlib -o PrimeService -lang VB

这个修正后的命令能够成功创建一个使用Visual Basic语言的类库项目。

扩展问题

在进一步测试中还发现，文档中关于创建xUnit测试项目的部分也存在类似问题。如果直接使用：

dotnet new xunit -o PrimeService.Tests

系统会默认创建C#版本的测试项目，而非VB.NET版本。

要创建VB.NET版本的xUnit测试项目，正确的命令应该是：

dotnet new xunit -o PrimeService.Tests -lang VB

技术背景

在.NET CLI工具中，-lang参数用于指定项目使用的编程语言。这个参数支持多种语言选项，包括：

• C# (使用-lang C#)
• F# (使用-lang F#)
• VB (使用-lang VB)

参数格式必须使用单横线-，这是.NET CLI工具的标准参数格式。双横线--通常用于更长的参数名称，但在dotnet new命令中并不适用。

最佳实践

当使用.NET CLI创建新项目时，建议：

1. 明确指定语言参数-lang，避免依赖默认设置
2. 使用正确的参数格式（单横线-）
3. 创建项目后检查项目文件(.vbproj)确认语言设置正确
4. 对于测试项目，确保测试框架(xUnit/NUnit/MSTest)与主项目一致

这些细节虽然看似微小，但对于确保项目正确初始化非常重要，特别是当团队使用多种.NET语言开发时。