构建你的第一个 Linux Shell 函数测试框架

为什么需要测试 Shell 函数？

Shell 脚本通常用于自动化任务、部署流程或系统维护。一旦脚本出错，可能导致服务中断、数据丢失等严重后果。通过为每个函数编写测试用例，你可以：

• 提前发现逻辑错误
• 确保修改后不会破坏原有功能（回归测试）
• 提升脚本的可维护性和可靠性

我们的目标：一个简易但实用的测试框架

我们不需要复杂的工具（如 Bats 或 ShUnit2），而是从零开始构建一个仅用 Bash 内置功能实现的轻量级测试框架。这个框架将支持：

• 定义测试函数
• 断言（assert）实际结果与期望结果是否一致
• 统计通过/失败的测试数量

第一步：编写待测试的函数

假设我们要测试一个名为 add 的函数，它接收两个数字并返回它们的和。

# file: math.shadd() {    echo $(($1 + $2))}

第二步：构建测试框架核心

创建一个 test_framework.sh 文件，包含以下内容：

# test_framework.sh# 全局变量：记录测试结果passed=0failed=0echo_result() {    if [ "$1" = "pass" ]; then        echo -e "\033[32mPASS\033[0m: $2"        ((passed++))    else        echo -e "\033[31mFAIL\033[0m: $2"        ((failed++))    fi}assert_equal() {    local expected="$1"    local actual="$2"    local test_name="$3"    if [ "$expected" = "$actual" ]; then        echo_result "pass" "$test_name"    else        echo_result "fail" "$test_name (expected: $expected, got: $actual)"    fi}run_tests() {    echo "Running tests..."    # 此处会调用所有以 test_ 开头的函数    for func in $(declare -F | cut -d' ' -f3 | grep '^test_'); do        $func    done    echo "\n--- Summary ---"    echo "Passed: $passed"    echo "Failed: $failed"        if [ $failed -eq 0 ]; then        echo -e "\033[32mAll tests passed!\033[0m"        exit 0    else        echo -e "\033[31mSome tests failed.\033[0m"        exit 1    fi}

第三步：编写测试用例

现在，我们为 add 函数编写测试。创建 test_math.sh：

# test_math.sh# 加载被测函数和测试框架source ./math.shsource ./test_framework.sh# 测试用例必须以 test_ 开头test_add_positive_numbers() {    result=$(add 2 3)    assert_equal "5" "$result" "add 2 and 3"}test_add_negative_numbers() {    result=$(add -1 -4)    assert_equal "-5" "$result" "add -1 and -4"}test_add_zero() {    result=$(add 0 5)    assert_equal "5" "$result" "add 0 and 5"}# 运行所有测试run_tests

第四步：运行测试

在终端中执行：

chmod +x test_math.sh./test_math.sh

如果一切正常，你会看到绿色的 “PASS” 输出，并显示 “All tests passed!”。

进阶建议

这个简易框架适合小型项目。对于更复杂的场景，你可以考虑使用专业的 Shell 脚本测试框架，如 Bats 或 ShUnit2。但理解基础原理，能让你更好地使用这些工具。

总结

通过本文，你学会了如何从零搭建一个轻量级的 Linux Shell 函数测试 框架。这不仅能提升你的 bash 单元测试 能力，还能显著提高 Shell 脚本的健壮性。记住，良好的测试习惯是专业开发者的标志！

现在就动手试试吧——为你的下一个 Shell 脚本加上测试，享受无 bug 的快乐！