退出代码
本课属于 Coddy ASP.NET Core 学习旅程的“C# 和 .NET 基础”单元。第 5 课,共 20 课。
程序结束时,会向启动它的程序返回一个退出代码:0 表示运行成功,其他值表示运行失败。脚本和构建服务器会读取这个数字。顶层语句通过 return 设置它。一旦某个 return 返回了一个数字,每条执行路径都必须以一个 return 结束,因此最后一行会变成 return 0;。如果没有它,编译器会报告错误 CS0161。
错误会通过 Console.Error.WriteLine 输出到第二个输出流 stderr。正常输出仍会发送到 stdout,因此即使有人将输出保存到文件中,也仍能看到错误。
if (args.Length != 1)
{
Console.Error.WriteLine("Usage: greet <name>");
return 1;
}
Console.WriteLine($"Hello, {args[0]}!");
return 0;挑战
简单让这个跟踪器像命令行工具一样失败:向 stderr 输出一条消息,并返回退出代码 1。
- 在
Program.cs的最后一行添加return 0;。 - 在
add分支的开头,当args.Length < 3时,使用Console.Error.WriteLine输出Usage: add <name> <amount>,并执行return 1;。现在,运行dotnet run -- add Lunch会崩溃,因为args[2]不存在。 - 使用
Console.Error.WriteLine输出Invalid amount: abc,并将其中的break;替换为return 1;。 - 在
default分支中也执行相同操作:将Unknown command: fly输出到 stderr,并让程序返回1。 Added Lunch: 12.50保留在 stdout 上,并且该次运行以0退出。
试试看:编辑器旁边的终端已经显示 dotnet run -- add Lunch,所以点击“运行”时会以红色显示 Usage: add <name> <amount>,因为这条消息被发送到了 stderr,而不是导致程序崩溃。将 12.50 添加到参数中,然后再次点击“运行”:Added Lunch: 12.50。终端不会显示退出代码,因此点击“检查”来读取它们:add Lunch abc 和 fly 必须以 1 退出,而 add Lunch 12.50 必须以 0 退出。
亲手试试
using System.Globalization;
var count = 0;
var total = 0m;
if (args.Length == 0)
{
Console.WriteLine("Expense Tracker");
Console.WriteLine($"{count} expenses");
Console.WriteLine($"Total: {total:F2}");
}
else
{
switch (args[0])
{
case "add":
if (!decimal.TryParse(args[2], CultureInfo.InvariantCulture, out var amount))
{
Console.WriteLine($"Invalid amount: {args[2]}");
break;
}
Console.WriteLine($"Added {args[1]}: {amount:F2}");
break;
default:
Console.WriteLine($"Unknown command: {args[0]}");
break;
}
}
这节课包含一个小测验。开始学习即可作答,并记录你的进度。