C#解析命令行参数推荐System.CommandLine库,手动解析仅适用于简单场景;前者提供强类型、自动帮助、子命令和验证,后者需自行处理选项拆分、类型转换和错误提示。

在 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或Argument,类型系统直接帮你做转换和校验 - 支持
--verbose、-o path.txt、--config="a.json"等多种写法,自动归一化 - 调用
command.InvokeAsync(args)即可执行,异常会自动转为友好错误提示 - 内置
dotnet-suggest支持终端自动补全(bash/zsh/PowerShell)
什么时候选哪个?
单文件小工具、教学示例、临时脚本,手动解析够用且无依赖;但只要涉及两个以上选项、需要帮助文档、未来可能加子命令(如 app build / app run),直接上 System.CommandLine 更省心。
本书是全面讲述PHP与MySQL的经典之作,书中不但全面介绍了两种技术的核心特性,还讲解了如何高效地结合这两种技术构建健壮的数据驱动的应用程序。本书涵盖了两种技术新版本中出现的最新特性,书中大量实际的示例和深入的分析均来自于作者在这方面多年的专业经验,可用于解决开发者在实际中所面临的各种挑战。 本书内容全面深入,适合各层次PHP和MySQL开发人员阅读,既是优秀的学习教程,也可用作参考手册。
它不是“重型框架”,API 简洁,学习成本低,而且和 .NET 生态深度集成(比如和 Microsoft.Extensions.DependencyInjection 配合做依赖注入)。
一个小提醒
别用 Environment.GetCommandLineArgs() 替代 args —— 它第一个元素是程序路径,容易出错;始终以 Main(string[] args) 的参数为准。
基本上就这些。不复杂,但容易忽略细节。









