单元测试

为单个函数/模块编写小型、快速、隔离、可靠的测试，并保证与项目现有技术栈一致。

何时使用

• 新功能要求测试覆盖。
• 修复 bug 时先补回归测试（防复发）。
• 重构高风险逻辑前建立“安全网”。

原则

• 一个用例测一个行为，用清晰的测试名描述“被测对象 → 条件 → 期望结果”。
• 隔离外部依赖：只测当前单元，网络/数据库/文件用 mock、stub、fakes。
• 只断言契约/行为，不绑定实现细节，减少脆弱测试。
• 3A 结构：Arrange（准备）→ Act（执行）→ Assert（断言）。

流程

1. 对齐项目既有约定

动手前先看已有测试：

• 用什么框架（JUnit/pytest/Jest/go test/CppUTest…）与断言库。
• 测试文件放哪、如何命名。
• 是否用 TDD 风格还是“实现后补测试”风格。
• 如何运行单个测试、如何跑全量。

2. 列出待覆盖的用例

对照被测代码的分支结构，覆盖：

• 正常路径（happy path）。
• 各边界值 / 极端值（空、0、负数、最大值、空串、null、临界索引）。
• 错误 / 异常路径与错误信息。
• 状态转换、并发/重入（如适用）。

3. 编写测试（示例：Python + pytest）

def add(a, b):
    """返回 a+b；任意参数为 None 时抛 ValueError。"""
    if a is None or b is None:
        raise ValueError("参数不能为 None")
    return a + b

def test_add_normal():
    assert add(2, 3) == 5            # happy path

def test_add_zero():
    assert add(0, 0) == 0            # 边界

def test_add_negative():
    assert add(-1, 1) == 0

def test_add_none_raises():
    with pytest.raises(ValueError):
        add(None, 3)                 # 异常路径

4. 隔离外部依赖（mock）

只对“被测单元绕过不掉的边界”做 mock，不要过度 mock。

from unittest.mock import patch

@patch("module.send_email")
def test_register_sends_mail(mock_send):
    register("a@b.com")
    mock_send.assert_called_once_with("a@b.com", ...)

5. 运行并验证（必须执行）

# 以 pytest 为例：先跑新写的，再跑全量
pytest path/to/test_file.py -k added       # 只跑新增
pytest                                      # 全量回归

• 确认：新测试先失败后通过（证明测试真的在测逻辑），再确认全量无回归。
• 若项目语言/框架不同，改用对应的运行命令（mvn test / go test / npm test…）。

完成标准

• 用与项目一致的框架与命名约定。
• 覆盖关键分支与边界/异常路径。
• 测试可脱离外部环境运行（mock 掉网络/DB）。
• 新测试运行通过，全量无回归。
• 测试名能描述场景，断言不依赖实现细节。