C# 如何解析命令行参数 - 手动解析与System.CommandLine库

来源:这里教程网 时间:2026-02-21 17:33:28 作者:

在 C# 中解析命令行参数,有两种主流方式:手动解析(适合简单场景)和使用

System.CommandLine
库(推荐用于中大型工具)。关键不在于“能不能做”,而在于“是否清晰、可维护、易扩展”。

手动解析:用 string[] args 做基础拆分

程序入口的

args
是一个字符串数组,不含程序名。你可以按约定自行识别短选项(如
-v
)、长选项(如
--output
)和参数值。

for
循环遍历,遇到
-
--
开头的项就视为选项,下一项或等号后的内容视为值
支持
-abc
合并短选项(需额外拆解为
-a -b -c
注意空格、引号包裹的含空格参数(如
"my file.txt"
)——手动解析时
args
已由运行时按 shell 规则分割,无需再处理引号
错误提示、帮助信息、类型转换(如把
"42"
转成
int
)都要自己写,容易遗漏边界情况

System.CommandLine:微软官方推荐的现代方案

System.CommandLine
是 .NET 5+ 内置支持、独立 NuGet 包(
System.CommandLine
v2.0+),提供强类型、自动帮助生成、子命令、验证和国际化能力。

定义
RootCommand
Option<t></t>
Argument<t></t>
,类型系统直接帮你做转换和校验
支持
--verbose
-o path.txt
--config="a.json"
等多种写法,自动归一化
调用
command.InvokeAsync(args)
即可执行,异常会自动转为友好错误提示
内置
dotnet-suggest
支持终端自动补全(bash/zsh/PowerShell)

什么时候选哪个?

单文件小工具、教学示例、临时脚本,手动解析够用且无依赖;但只要涉及两个以上选项、需要帮助文档、未来可能加子命令(如

app build
/
app run
),直接上
System.CommandLine
更省心。

它不是“重型框架”,API 简洁,学习成本低,而且和 .NET 生态深度集成(比如和

Microsoft.Extensions.DependencyInjection
配合做依赖注入)。

一个小提醒

别用

Environment.GetCommandLineArgs()
替代
args
—— 它第一个元素是程序路径,容易出错;始终以
Main(string[] args)
的参数为准。

基本上就这些。不复杂,但容易忽略细节。

相关推荐