Menu
CoddyTech

退出代码

本课属于 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;
challenge icon

挑战

简单

让这个跟踪器像命令行工具一样失败:向 stderr 输出一条消息,并返回退出代码 1。

  1. 在 Program.cs 的最后一行添加 return 0;。
  2. 在 add 分支的开头,当 args.Length < 3 时,使用 Console.Error.WriteLine 输出 Usage: add <name> <amount>,并执行 return 1;。现在,运行 dotnet run -- add Lunch 会崩溃,因为 args[2] 不存在。
  3. 使用 Console.Error.WriteLine 输出 Invalid amount: abc,并将其中的 break; 替换为 return 1;。
  4. 在 default 分支中也执行相同操作:将 Unknown command: fly 输出到 stderr,并让程序返回 1。
  5. 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;
    }
}
quiz icon自我测试

这节课包含一个小测验。开始学习即可作答,并记录你的进度。

C# 和 .NET 基础中的所有课