Ruby 异常与错误处理
错误是编程中不可避免的一部分。无论是用户输入了无效数据、试图读取不存在的文件，还是网络连接突然中断，这些突发状况都可能导致程序崩溃或产生不可预知的行为。
一个健壮的应用程序会提前预判这些问题，并被设计成能够优雅地处理它们，从而防止程序突然终止，并向用户提供有用的反馈。本章将向你介绍 Ruby 处理这些运行时问题的核心机制：begin...rescue 代码块。通过学习使用 begin...rescue，你将获得在错误发生时“捕获”它们的能力，让你的程序能够以可控的方式恢复或做出响应，而不是直接崩溃。这是编写更具弹性、对用户更友好的 Ruby 应用程序的关键一步，尤其是在像前几章那样与文件等外部资源进行交互时。
1. 理解异常 (Exceptions)
在深入研究如何处理错误之前，我们需要先了解我们所说的错误到底是什么。在 Ruby 以及许多其他编程语言中，这些运行时发生的错误被称为异常 (Exceptions)。
异常是指在程序执行期间发生的、打乱正常指令流的事件。它是程序遇到的一个意外问题。与阻止代码运行的语法错误（例如缺少 end 关键字）不同，异常发生在你的代码运行期间。如果异常没有被处理，它通常会导致程序停止执行，并在控制台中显示一条错误信息（称为“堆栈跟踪”）。
让我们来看几个常见的场景：
1.1 除以零
result = 10 / 0 # 这将引发一个 ZeroDivisionError (除零错误)
puts result如果你运行这段代码，Ruby 会在执行到 10 / 0 时停止，并显示 ZeroDivisionError: divided by 0。下一行的 puts result 永远不会被执行。
1.2 访问无效的数组索引
my_array = [1, 2, 3]
puts my_array[5] # 这不会引发异常，而是返回 nil。但在某些语言中，这会引发索引越界错误。
puts my_array.fetch(5) # 这 *将会* 引发一个 IndexError (索引错误)虽然 my_array[5] 会优雅地返回 nil，但当索引 5 不存在时，使用 fetch(5) 将会引发一个 IndexError: index 5 outside of array bounds: -3...3。
1.3 打开不存在的文件
（这与我们之前学习的文件 I/O 直接相关）
# 这种场景在处理文件时非常常见
file = File.open("non_existent_file.txt", "r")
puts file.read
file.close如果 non_existent_file.txt 不存在，File.open 方法将引发一个 Errno::ENOENT: No such file or directory 异常。这是一个非常关键的需要处理的异常，尤其是在处理用户指定的文件路径时。
Ruby 拥有一个异常类别的层级结构。你将遇到的大多数常见异常，以及 begin...rescue 默认处理的异常，都继承自 StandardError（标准错误）。这包括诸如 ZeroDivisionError、ArgumentError、IOError 以及 Errno::ENOENT 等异常。
2. begin...rescue 代码块
begin...rescue 代码块是 Ruby 用于处理异常的基础结构。它允许你指定一段需要“监控”潜在异常的代码。如果在该部分代码中发生异常，程序执行流不会崩溃，而是跳转到一个特殊的 rescue 代码块，你可以在那里定义如何响应这个错误。
2.1 基本语法
最简单的 begin...rescue 形式如下所示：
begin
# 可能会引发异常的代码
# 这里是“受保护的”区域
puts "正在尝试执行具有潜在风险的操作..."
result = 10 / 0 # 这行代码会引发 ZeroDivisionError
puts "操作成功：#{result}" # 这行代码不会被执行到
rescue
# 如果 'begin' 块中发生异常，则执行这里的代码
puts "发生了一个错误！"
end
puts "错误处理完毕，程序继续执行。"让我们分解一下执行流程：
- Ruby 解释器进入
begin代码块。 - 它尝试按顺序执行
begin块内的代码。 - 如果没有发生异常，
rescue块将被完全跳过，程序在end关键字之后继续执行。 - 如果在
begin块内的任何一点发生了异常（例如这里的10 / 0），begin块内剩余的代码将立即停止执行。 - Ruby 解释器随后直接跳转到
rescue代码块，并执行里面的代码。 rescue块执行完毕后，程序继续执行end关键字之后的任何代码。
在上面的例子中，10 / 0 引发了 ZeroDivisionError。puts "操作成功..." 这行代码被跳过。程序跳转到 rescue 块，打印“发生了一个错误！”，然后继续打印“错误处理完毕，程序继续执行。”。
3. 访问异常对象
当一个异常被捕获（rescued）时，Ruby 会使该异常对象可用。这个对象包含了关于该错误的宝贵信息，例如它的类（错误类型）和一段描述性的消息。你可以使用 rescue => e 来捕获这个对象。e 是用于表示异常对象的一个常见约定，但你可以使用任何变量名。
begin
puts "正在尝试执行除法..."
# 通过尝试打开一个不存在的文件来模拟错误
File.open("non_existent.txt", "r") # 这会引发 Errno::ENOENT
puts "文件打开成功！"
rescue => e # 'e' 现在保存了异常对象
puts "捕获到了一个异常！"
puts "错误类型：#{e.class}" # 打印异常的类 (例如 Errno::ENOENT)
puts "错误信息：#{e.message}" # 打印具体的错误描述信息
end
puts "已越过错误处理区，程序继续执行。"在这个例子中，如果 non_existent.txt 不存在，就会引发一个 Errno::ENOENT 异常。rescue => e 块捕获了它，然后我们可以使用 e.class 和 e.message 打印关于错误的详细信息。这些信息对于调试代码以及向用户提供具有参考价值的反馈来说至关重要。
4. 捕获特定类型的异常
默认情况下，没有指定异常类的 rescue 子句会捕获 StandardError 以及所有继承自 StandardError 的类。这涵盖了大多数常见的运行时异常。但是，你可以通过指定想要捕获的异常类型，让你的错误处理更加精确。当你希望以不同方式处理不同类型的错误时，这非常有用。
你可以在 rescue 关键字之后指定一个（或多个）异常类：
begin
puts "请输入一个数字："
input = gets.chomp
num = Integer(input) # 如果输入不是有效的整数，这可能会引发 ArgumentError
puts "请输入另一个数字作为除数："
divisor_input = gets.chomp
divisor = Integer(divisor_input)
result = num / divisor # 如果除数为 0，这可能会引发 ZeroDivisionError
puts "结果：#{result}"
rescue ZeroDivisionError
puts "错误：你不能除以零！"
rescue ArgumentError => e
# 专门捕获 ArgumentError，并获取它的错误信息
puts "错误：无效的输入。请输入有效的整数。详情：#{e.message}"
rescue => e
# 这个通用的 rescue 将捕获上面没有捕获到的任何其他 StandardError
puts "发生了一个未知的错误：#{e.class} - #{e.message}"
end
puts "程序结束。"在这个综合示例中：
- 如果用户在输入第一个数字时输入了 "hello"，
Integer(input)会引发一个ArgumentError。此时rescue ArgumentError块将被执行。 - 如果用户输入了 "5" 然后输入了 "0"，
num / divisor会引发一个ZeroDivisionError。此时rescue ZeroDivisionError块将被执行。 - 如果发生了任何其他的
StandardError（既不是ZeroDivisionError也不是ArgumentError），通用的rescue => e块将会捕获它。捕获未预见的问题是一个很好的编程习惯。
重要提示： Ruby 会按顺序尝试匹配 rescue 代码块。如果一个异常匹配了较早的 rescue 子句，它就会被那个子句处理，后续针对更通用异常的 rescue 子句将被跳过。因此，标准做法是将更具体的异常类型放在前面，更通用的放在后面。
5. 实战示例与演示
让我们把 begin...rescue 应用到实际场景中，尤其是涉及文件操作和用户输入的场景，这些都是错误的常见来源。
5.1 示例 1：处理缺失的文件
在之前的模块中，我们学习了读取和写入文件。一个非常常见的问题是试图打开一个不存在的文件。这会引发 Errno::ENOENT 异常。
def read_file_content(filename)
begin
file = File.open(filename, "r") # 尝试打开文件进行读取
content = file.read # 读取文件内容
file.close # 关闭文件
puts "成功从 '#{filename}' 读取内容："
puts content
return content
rescue Errno::ENOENT => e
# 专门针对“没有该文件或目录”错误的 rescue
puts "错误：未找到文件 '#{filename}'。请检查路径。"
puts "详情：#{e.message}"
return nil # 表示失败
rescue IOError => e
# 捕获一般的 I/O 错误，例如权限被拒绝，或文件已在打开状态
puts "错误：读取 '#{filename}' 时发生 I/O 问题。"
puts "详情：#{e.message}"
return nil
rescue => e
# 捕获任何其他意外的 StandardError
puts "处理 '#{filename}' 时发生意外错误："
puts "错误类型：#{e.class}"
puts "错误信息：#{e.message}"
return nil
end
end
puts "--- 尝试读取一个存在的文件 ---"
# 创建一个测试文件用于演示
File.write("my_data.txt", "你好，Ruby！\n这是一个测试文件。")
read_file_content("my_data.txt")
puts "\n"
puts "--- 尝试读取一个不存在的文件 ---"
read_file_content("non_existent_file.txt")
puts "\n"
puts "--- 尝试读取一个权限受限的文件 (假设场景) ---"
# 这模拟了如果 'restricted.txt' 存在但 Ruby 没有读取权限的情况
# 在实际测试中，你可能需要手动创建这样一个文件并更改其权限。
# 现在，我们仅仅演示如果引发 IOError 会输出什么。
# 假设如果权限被拒绝，这个调用会引发 IOError：
# read_file_content("/etc/shadow") # (除非你知道你在做什么，否则不要在真实环境中运行这个！)
# 为了演示，我们将手动模拟 IOError 的输出
puts "正在尝试读取 'restricted.txt' (如果权限被拒绝，模拟引发 IOError)..."
puts "由于权限问题，文件 'restricted.txt' (模拟) 无法被读取。"在这个例子中，read_file_content 方法展示了在文件缺失时如何处理 Errno::ENOENT，以及对于其他文件相关问题如何处理 IOError。如果文件不存在，程序不会崩溃，而是优雅地打印一条错误信息。
5.2 示例 2：用于简易计算器的健壮用户输入
让我们重温一下用户输入（第七模块）和整数转换，创建一个更健壮的计算器，它不会因为无效输入或除以零而崩溃。
def perform_division
begin
puts "请输入第一个数字："
num1_str = gets.chomp
num1 = Integer(num1_str) # 可能会引发 ArgumentError
puts "请输入第二个数字："
num2_str = gets.chomp
num2 = Integer(num2_str) # 可能会引发 ArgumentError
result = num1 / num2 # 可能会引发 ZeroDivisionError
puts "#{num1} / #{num2} 的结果是：#{result}"
rescue ArgumentError => e
# 处理 Integer() 转换失败的情况 (例如，输入是 "abc")
puts "无效输入！请确保你只输入了整数。"
puts "具体错误：#{e.message}"
rescue ZeroDivisionError
# 处理除以零的情况
puts "不能除以零！请输入一个非零的第二个数字。"
rescue => e
# 捕获任何其他意外的 StandardError
puts "计算过程中发生了意外错误：#{e.class} - #{e.message}"
end
end
puts "--- 第一次尝试：有效输入 ---"
# 用户输入：10, 2
perform_division
puts "\n"
puts "--- 第二次尝试：无效输入 (非整数) ---"
# 用户输入：hello, 5
perform_division
puts "\n"
puts "--- 第三次尝试：除以零 ---"
# 用户输入：10, 0
perform_division
puts "\n"
puts "--- 第四次尝试：另一次有效输入 ---"
# 用户输入：20, 4
perform_division
puts "\n"这种方法让程序变得更具弹性和用户友好性，因为它不仅没有崩溃，还在出现问题时给了用户明确的引导。