VSTest.Console.exe 命令行选项
VSTest.Console.exe 是用于运行测试的命令行工具。 可以在命令行上按任意顺序指定多个选项。 这些选项列在 常规命令行选项。
注意
Visual Studio 中的 MSTest 适配器也适用于旧模式（相当于使用 mstest.exe运行测试），以便兼容。 在旧模式下，它不能利用 TestCaseFilter 功能。 指定 testsettings 文件时，适配器可以切换到旧模式，forcelegacymode 设置为 runsettings 文件中的 true，或使用 HostType等属性。
若要在基于 ARM 体系结构的计算机上运行自动测试，必须使用 VSTest.Console.exe。
打开 开发人员命令提示符 以使用命令行工具，也可以在 %Program Files（x86）%\Microsoft Visual Studio\<版本>\<版本>\common7\ide\CommonExtensions\<Platform 中找到该工具 |Microsoft>。
常规命令行选项
下表列出了 VSTest.Console.exe 的所有选项及其简短说明。 可以通过在命令行中键入 VSTest.Console/? 来查看类似的摘要。
| 选择 | 描述 |
|---|---|
| [测试文件名] | 从指定的文件运行测试。 使用空格分隔多个测试文件名。 示例： mytestproject.dll、mytestproject.dll myothertestproject.exe |
| /Settings：[文件名] | 使用其他设置（如数据收集器）运行测试。 有关详细信息，请参阅 使用 .runsettings 文件 配置单元测试 示例： /Settings:local.runsettings |
| /Tests：[测试名称] | 使用包含提供的值的名称运行测试。 此命令与完整测试名称（包括命名空间）匹配。 若要提供多个值，请用逗号分隔它们。 示例： /Tests:TestMethod1,testMethod2/Tests 命令行选项不能与 /TestCaseFilter 命令行选项一起使用。 |
| /Parallel | 指定并行执行测试。 默认情况下，最多可以使用计算机上的所有可用核心。 可以配置在设置文件中要使用的核心数。 |
| /Enablecodecoverage | 在测试运行中启用数据诊断适配器 CodeCoverage。 如果未使用设置文件指定默认设置，则使用默认设置。 |
| /InIsolation | 在独立进程中运行测试。 这种隔离使得 vstest.console.exe 进程不太可能在测试中出错时停止，但测试可能会运行较慢。 |
| /UseVsixExtensions | 此选项使 vstest.console.exe 进程使用或跳过在测试运行中安装的 VSIX 扩展（如果有）。 此选项已弃用。 从 Visual Studio 的下一个主要版本开始，此选项可能会被删除。 移动到使用作为 NuGet 包提供的扩展。 示例： /UseVsixExtensions:true |
| /TestAdapterPath：[路径] | 强制 vstest.console.exe 进程在测试运行中使用指定路径（如果有）中的自定义测试适配器。 示例： /TestAdapterPath:[pathToCustomAdapters] |
| /Platform：[平台类型] | 强制使用给定平台，而不是从当前运行时确定的平台。 此选项只能在 Windows 上强制 x86 和 x64 平台。 ARM 选项已损坏，将导致大多数系统上出现 x64。 请勿指定此选项以在不在有效值列表中（如 ARM64）的运行时上运行。 有效值为 x86、x64 和 ARM。 |
| /Framework：[框架版本] | 要用于测试执行的 .NET 版本。 示例值为 Framework35、Framework40、Framework45、FrameworkUap10、.NETCoreApp,Version=v1.1。TargetFrameworkAttribute 用于自动检测程序集中的此选项，在属性不存在时默认为 Framework40。 如果从 .NET Core 程序集中删除 TargetFrameworkAttribute，则必须显式指定此选项。如果目标框架指定为 Framework35，则测试在 CLR 4.0“兼容模式”中运行。 示例： /Framework:framework40 |
| /TestCaseFilter：[表达式] | 运行与给定表达式匹配的测试。 <表达式> 的格式为 <属性>=<值>[|<表达式>]。 示例： /TestCaseFilter:"Priority=1"示例： /TestCaseFilter:"TestCategory=Nightly|FullyQualifiedName=Namespace.ClassName.MethodName"/TestCaseFilter 命令行选项不能与 /Tests 命令行选项一起使用。 有关创建和使用表达式的信息，请参阅 TestCase 筛选器。 |
| /？ | 显示使用情况信息。 |
| /Logger：[uri/friendlyname] | 指定测试结果的记录器。 多次指定参数以启用多个记录器。 示例：若要将结果记录到 Visual Studio 测试结果文件（TRX），请使用 /Logger：trx [;LogFileName=<默认为唯一文件名>] |
| /ListTests：[文件名] | 列出给定测试容器中发现的测试。 注意：列出测试时， /TestCaseFilters 选项不起作用;它仅控制运行哪些测试。 |
| /ListDiscoverers | 列出已安装的测试发现器。 |
| /ListExecutors | 列出已安装的测试执行程序。 |
| /ListLoggers | 列出已安装的测试记录器。 |
| /ListSettingsProviders | 列出已安装的测试设置提供程序。 |
| /Blame | 在归咎模式下运行测试。 此选项有助于隔离导致测试主机崩溃的问题测试。 检测到崩溃时，它会在 TestResults/<Guid>/<Guid>_Sequence.xml 中创建一个序列文件，用于捕获在崩溃前运行的测试顺序。 有关详细信息，请参阅 归咎于数据收集器。 |
| /Diag：[文件名] | 将诊断跟踪日志写入指定文件。 |
| /ResultsDirectory：[路径] | 如果不存在，将在指定路径中创建测试结果目录。 示例： /ResultsDirectory:<pathToResultsDirectory> |
| /ParentProcessId：[parentProcessId] | 负责启动当前进程的父进程的进程 ID。 |
| /Port：[端口] | 套接字连接的端口和接收事件消息。 |
| /Collect：[dataCollector friendlyName] | 为测试运行启用数据收集器。 详细信息。 |
提示
选项和值不区分大小写。
例子
运行 vstest.console.exe 的语法为：
vstest.console.exe [TestFileNames] [Options]
默认情况下，该命令在正常退出时返回 0，即使未发现任何测试。 如果要在未发现测试的情况下返回非零值，请使用 <TreatNoTestsAsError>true</TreatNoTestsAsError> runsettings 选项。
以下命令针对测试库 myTestProject.dll运行 vstest.console.exe：
vstest.console.exe myTestProject.dll
以下命令使用多个测试文件运行 vstest.console.exe。 使用空格分隔测试文件名：
vstest.console.exe myTestFile.dll myOtherTestFile.dll
以下命令使用多个选项运行 vstest.console.exe。 它在隔离进程中的 myTestFile.dll 文件中运行测试，并使用 Local.RunSettings 文件中指定的设置。 此外，它只运行标记为“Priority=1”的测试，并将结果记录到 .trx 文件中。
vstest.console.exe myTestFile.dll /Settings:Local.RunSettings /InIsolation /TestCaseFilter:"Priority=1" /Logger:trx
以下命令使用测试库 myTestProject.dll的 /blame 选项运行 vstest.console.exe：
vstest.console.exe myTestFile.dll /blame
如果发生了测试主机故障，则会生成 sequence.xml 文件。 该文件在其执行序列中包含测试的完全限定名称，包括崩溃时运行的特定测试。
如果没有测试主机崩溃，则不会生成 sequence.xml 文件。
生成的 sequence.xml 文件的示例：
<?xml version="1.0"?>
<TestSequence>
<Test Name="TestProject.UnitTest1.TestMethodB" Source="D:\repos\TestProject\TestProject\bin\Debug\TestProject.dll" />
<Test Name="TestProject.UnitTest1.TestMethodA" Source="D:\repos\TestProject\TestProject\bin\Debug\TestProject.dll" />
</TestSequence>
UWP 示例
对于 UWP，必须引用 appxrecipe 文件而不是 DLL。
vstest.console.exe /Logger:trx /Platform:x64 /framework:frameworkuap10 UnitTestsUWP\bin\x64\Release\UnitTestsUWP.build.appxrecipe