在 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.CommandLinev2.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)的参数为准。
基本上就这些。不复杂,但容易忽略细节。
