# Shell 测试框架专家使用 unix-goto 项目的模式和方法对 bash shell 脚本进行全面的测试专业知识，强调 100% 测试覆盖率、系统测试组织和性能验证。 ## 何时使用此技能在以下情况下使用此技能： * 为 bash shell 脚本编写测试套件 * 实施100%测试覆盖率要求 * 将测试组织为单元、集成、边缘情况和性能类别 * 为 shell 脚本验证创建断言模式 * 设置测试基础设施和助手 * 编写shell函数的性能测试 * 生成测试报告和摘要 * 调试测试失败 * 验证 shell 脚本行为请勿将此技能用于： * 测试非 shell 应用程序（使用特定于语言的框架） * 简单的临时脚本验证 * 生产测试（仅用于开发/CI） * 一般 QA 测试（这是以开发人员为中心的单元测试） ## 核心测试理念 ### 100% 覆盖率规则 unix-goto 中的每个核心功能都有 100% 的测试覆盖率。这是没有商量余地的。 **覆盖范围要求：** * 核心导航：100% * 缓存系统：100% * 书签：100% *历史：100% * 基准：100% * 新功能：100% **这意味着什么：** * 每个功能都有测试 * 每个代码路径都被执行 * 每个错误条件都经过验证 * 每个边缘情况都被覆盖 * 每个绩效目标均经过验证 ### 测试驱动开发方法 **工作流程：** 1. 首先编写测试（基于功能规范） 2.观察测试失败（红色） 3. 实现功能 4.手表测试通过（绿色） 5. 如果需要的话重构 6. 验证所有测试仍然通过 ## 核心知识 ### 标准测试文件结构每个测试文件都遵循以下精确结构： #!/bin/bash # [feature] 功能的测试套件 set -e # 出错时退出 #============================================== # 设置 #============================================== SCRIPT_DIR="$(cd "$(目录名 "$0")" && pwd)" 源“$SCRIPT_DIR/lib/module.sh” #============================================== # 测试计数器 #============================================== 测试通过=0 测试失败=0 #============================================== # 测试助手 #============================================== 通过（）{ 回声“✓通过：$1” ((测试通过++)) } 失败（）{ echo "✗ 失败: $1" ((测试失败++)) } #============================================== # 测试函数 #============================================== # 测试 1：[类别] - [描述] 测试功能基本（）{ # 安排本地输入=“测试” 本地预期=“expected_output” # 行动本地结果=$(function_under_test "$input") # 断言 if [[ "$结果" == "$预期" ]];然后通过“基本功能测试” 否则失败“基本功能测试：预期'$expected'，得到'$result'” 菲 } #============================================== # 测试执行 #============================================== # 运行所有测试测试功能基本 #============================================== # 总结 #============================================== 回声“” 回声“═══════════════════ ════════════════════》 echo“测试通过：$TESTS_PASSED” echo“测试失败：$TESTS_FAILED” 回声“═══════════════════ ════════════════════》 # 使用正确的代码退出 [ $TESTS_FAILED -eq 0 ] && 退出 0 || 1号出口 ### 安排-执行-断言模式每个测试功能都必须遵循以下三相结构： **1\.安排** \- 设置测试条件 # 安排本地输入=“测试值” 本地预期=“预期结果” 本地临时文件=$(mktemp) echo“测试数据”>“$temp_file” **2\. Act** \- 执行被测代码 # 行动本地结果=$(function_under_test "$input") 本地退出代码=$? **3\.断言** \- 验证结果 # 断言 if [[ "$result" == "$expected" && $exit_code -eq 0 ]];然后通过“测试说明” 否则失败“测试失败：预期'$expected'，得到'$result'” 菲 **完整示例：** test_cache_lookup_single_match() { # 安排 - 创建具有单个匹配的缓存本地cache_file =“$ HOME / .goto_index” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 #--- unix-goto|/用户/manu/Git_Repos/unix-goto|2|1234567890 EOF # Act - 查找文件夹本地结果=$(__goto_cache_lookup "unix-goto") 本地退出代码=$? # 断言 - 应返回确切路径本地预期=“/Users/manu/Git_Repos/unix-goto” if [[ "$result" == "$expected" && $exit_code -eq 0 ]];然后通过“缓存查找返回单个匹配” 否则失败“预期‘$expected’，代码为 0，得到‘$result’，代码为 $exit_code” 菲 } ### 四个测试类别每个功能都需要在所有四个类别中进行测试： #### 第 1 类：单元测试 **目的：** 单独测试各个功能 **特点：** * 测试中的单一功能 * 最小的依赖 * 快速执行（每次测试<1ms） * 清晰、集中的主张 **示例 - 缓存查找单元测试：** test_cache_lookup_not_found() { # 安排本地cache_file =“$ HOME / .goto_index” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 #--- unix-goto|/用户/manu/Git_Repos/unix-goto|2|1234567890 EOF # 行动本地结果=$(__goto_cache_lookup "不存在") 本地退出代码=$? # 断言 if [[ -z "$result" && $exit_code -eq 1 ]];然后传递“未找到缓存查找返回代码 1” 否则失败“预期结果为空，代码为 1，得到 '$result'，代码为 $exit_code” 菲 } test_cache_lookup_multiple_matches() { # 安排本地cache_file =“$ HOME / .goto_index” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 #--- 项目|/用户/manu/project1|2|1234567890 项目|/用户/manu/project2|2|1234567891 EOF # 行动本地结果=$(__goto_cache_lookup“项目”) 本地退出代码=$? # 断言 - 应返回代码 2 的所有匹配项本地 line_count=$(echo "$result" | wc -l) if [[ $line_count -eq 2 && $exit_code -eq 2 ]];然后通过“缓存查找返回与代码 2 的多个匹配项” 否则失败“预期有 2 行，代码为 2，得到了 $line_count 行，代码为 $exit_code” 菲 } **单元测试清单：** * 使用有效输入进行测试 * 使用无效输入进行测试 * 使用空输入进行测试 * 用边界值进行测试 * 测试返回码 * 测试输出格式 #### 第 2 类：集成测试 **目的：**测试多个模块如何协同工作 **特点：** * 多个功能/模块交互 * 测试真实的工作流程 * 验证端到端行为 * 中等执行时间（每次测试<100ms） **示例 - 导航集成测试：** test_navigation_with_cache() { # Arrange - 设置完整的导航环境本地cache_file =“$ HOME / .goto_index” 本地history_file =“$HOME/.goto_history” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 #--- unix-goto|/用户/manu/Git_Repos/unix-goto|2|1234567890 EOF # Act - 执行完整导航本地start_dir=$(pwd) goto unix 转到本地 nav_exit_code=$? 本地 end_dir=$(pwd) # 断言 - 应该导航和跟踪历史记录本地预期_dir =“/Users/manu/Git_Repos/unix-goto” 本地history_recorded=false if grep -q "$expected_dir" "$history_file" 2>/dev/null;然后历史记录=true 菲 if [[ "$end_dir" == "$expected_dir" && $nav_exit_code -eq 0 && $history_recorded == true ]];然后通过“使用缓存和历史跟踪进行导航” 否则失败“集成测试失败：nav=$nav_exit_code，dir=$end_dir，history=$history_recorded” 菲 # 清理 cd“$start_dir” } test_bookmark_creation_and_navigation() { # 安排本地 bookmark_file="$HOME/.goto_bookmarks" rm -f "$bookmark_file" # Act - 创建书签并导航书签添加 testwork /Users/manu/work 本地add_code=$? 转到@testwork 本地导航代码=$? 本地 nav_dir=$(pwd) # 断言本地预期_dir =“/用户/手册/工作” if [[ $add_code -eq 0 && $nav_code -eq 0 && "$nav_dir" == "$expected_dir" ]];然后通过“书签创建和导航集成” 否则失败“集成失败：add=$add_code，nav=$nav_code，dir=$nav_dir” 菲 } **集成测试清单：** * 测试普通用户工作流程 * 测试模块交互 * 测试数据持久化 * 测试状态变化 * 测试错误传播 * 测试清理行为 #### 第 3 类：边缘情况 **目的：**测试边界条件和异常情况 **特点：** * 不寻常但有效的输入 * 边界条件 * 错误场景 * 比赛条件 * 资源限制 **示例 - 边缘情况测试：** 测试_空_缓存_文件（）{ # 排列 - 创建空缓存文件本地cache_file =“$ HOME / .goto_index” 触摸“$cache_file” # 行动本地结果=$(__goto_cache_lookup“任何内容”) 本地退出代码=$? # 断言 - 应该优雅地处理 if [[ -z "$result" && $exit_code -eq 1 ]];然后通过“优雅地处理空缓存文件” 否则失败“空缓存应返回代码 1” 菲 } test_malformed_cache_entry() { # 安排 - 缓存包含格式错误的条目本地cache_file =“$ HOME / .goto_index” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 #--- unix-goto|/路径|缺失|字段有效条目|/有效/路径|2|1234567890 EOF # 行动本地结果=$(__goto_cache_lookup“有效条目”) 本地退出代码=$? # 断言 - 仍应找到有效条目 if [[ "$result" == "/valid/path" && $exit_code -eq 0 ]];然后通过“格式错误的条目不会破坏有效的查找” 否则失败“应该优雅地处理格式错误的条目” 菲 } 测试非常长路径（）{ # 排列 - 创建具有很长路径的条目本地 long_path=$(printf '/very/long/path/%.0s' {1..50}) 本地cache_file =“$ HOME / .goto_index” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 #--- 长路径|${long_path}|50|1234567890 EOF # 行动本地结果=$(__goto_cache_lookup“长路径”) 本地退出代码=$? # 断言 - 应该处理长路径 if [[ "$result" == "$long_path" && $exit_code -eq 0 ]];然后通过“正确处理非常长的路径” 否则失败“长路径处理失败” 菲 } test_special_characters_in_folder_name() { # 排列 - 包含特殊字符的文件夹本地cache_file =“$ HOME / .goto_index” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 #--- my-project_v2.0|/Users/manu/my-project_v2.0|2|1234567890 EOF # 行动本地结果=$(__goto_cache_lookup“my-project_v2.0”) 本地退出代码=$? # 断言 if [[ "$result" == "/Users/manu/my-project_v2.0" && $exit_code -eq 0 ]];然后传递“文件夹名称中的特殊字符” 否则失败“特殊字符处理失败” 菲 } 测试并发缓存访问（）{ # 安排本地cache_file =“$ HOME / .goto_index” __goto_cache_build # Act - 模拟并发访问（对于 {1..10} 中的 i；做 __goto_cache_lookup“unix-goto”& 完成等待）本地退出代码=$? # 断言 - 应该处理并发读取如果 [[ $exit_code -eq 0 ]];然后通过“已处理的并发缓存访问” 否则失败“并发访问失败” 菲 } **边缘情况测试清单：** * 空输入 * 丢失文件 * 格式错误的数据 * 非常大的输入 * 特殊字符 * 并发访问 * 资源耗尽 * 权限错误 #### 第 4 类：性能测试 **目的：** 验证是否达到绩效目标 **特点：** * 测量执行时间 * 与目标比较 * 使用统计分析 * 大规模测试 **示例 - 性能测试：** 测试缓存查找速度（）{ # 安排 - 构建缓存 __goto_cache_build # Act - 测量查找时间本地开始=$(日期+%s%N) __goto_cache_lookup“unix-goto” 本地端=$(日期+%s%N) # 断言 - 应<100ms 本地持续时间=$(((结束 - 开始) / 1000000)) 本地目标=100 如果 [ $duration -lt $target ];然后通过“缓存查找速度：${duration}ms（目标：<${target}ms）” 否则失败“缓存太慢：${duration}ms（目标：<${target}ms）” 菲 } 测试缓存构建性能（）{ # 安排 - 清理缓存 rm -f ~/.goto_index # Act - 测量构建时间本地开始=$(日期+%s%N) __goto_cache_build 本地端=$(日期+%s%N) # 断言 - 应 <5 秒本地持续时间=$(((结束 - 开始) / 1000000)) 本地目标=5000 如果 [ $duration -lt $target ];然后通过“缓存构建速度：${duration}ms（目标：<${target}ms）” 否则失败“缓存构建太慢：${duration}ms（目标：<${target}ms）” 菲 } 测试历史检索速度（）{ # 排列 - 创建包含 100 个条目的历史记录本地history_file =“$HOME/.goto_history” rm -f "$history_file" 对于 {1..100} 中的 i；做 echo "$(date +%s)|/path/to/dir$i" >> "$history_file" 完成 # Act - 测量检索时间本地开始=$(日期+%s%N) __goto_recent_dirs 10 本地端=$(日期+%s%N) # 断言 - 应<10ms 本地持续时间=$(((结束 - 开始) / 1000000)) 本地目标=10 如果 [ $duration -lt $target ];然后通过“历史检索：${duration}ms（目标：<${target}ms）” 否则失败“历史记录太慢：${duration}ms（目标：<${target}ms）” 菲 } test_benchmark_cache_at_scale() { # 安排 - 创建大工作区本地工作区=$(mktemp -d) 对于 {1..500} 中的 i；做 mkdir -p“$工作空间/文件夹-$i” 完成 # Act - 构建缓存并测量查找本地 old_paths="$GOTO_SEARCH_PATHS" 导出 GOTO_SEARCH_PATHS="$workspace" __goto_cache_build 本地开始=$(日期+%s%N) __goto_cache_lookup“文件夹250” 本地端=$(日期+%s%N) # 断言 - 即使有 500 个文件夹，也应该 <100 毫秒本地持续时间=$(((结束 - 开始) / 1000000)) 本地目标=100 如果 [ $duration -lt $target ];然后通过“大规模缓存（500 个文件夹）：${duration}ms” 否则失败“大规模缓存太慢：${duration}ms” 菲 # 清理导出 GOTO_SEARCH_PATHS="$old_paths" rm -rf "$工作空间" } **性能测试清单：** * 衡量关键路径操作 * 与既定目标进行比较 * 以真实规模进行测试 * 最大负载测试 * 计算统计数据（最小值/最大值/平均值/中值） * 验证没有性能回归 ### 断言模式 #### 基本断言 **字符串相等：** 断言_等于（）{ 本地预期=“$1” 本地实际值=“$2” 本地消息=“$ {3：-字符串相等}” if [[ "$实际" == "$预期" ]];然后传递“$消息” 否则失败“$message：预期'$expected'，得到'$actual'” 菲 } # 用法 assert_equal "expected" "$result" "函数返回期望值" **退出代码断言：** 断言_成功（）{ 本地退出代码=$? local message="${1:-命令应该成功}" 如果 [ $exit_code -eq 0 ];然后传递“$消息” 否则失败“$message：退出代码$exit_code” 菲 } 断言_失败（）{ 本地退出代码=$? local message="${1:-命令应该失败}" 如果 [ $exit_code -ne 0 ];然后传递“$消息” 否则失败“$message：预期的非零退出代码” 菲 } # 用法一些命令 assert_success "命令执行成功" **数字比较：** 断言_小于（）{ 当地实际=$1 本地限额=$2 local message="${3:-值应小于限制}" if [ $actual -lt $limit ];然后传递“$message：$actual < $limit” 否则失败“$消息：$实际> = $限制” 菲 } 断言_大于（）{ 当地实际=$1 本地限额=$2 local message="${3:-值应大于限制}" 如果 [ $实际 -gt $限制 ];然后通过“$消息：$实际> $限制” 否则失败“$message：$actual <= $limit” 菲 } # 用法 assert_less_than $duration 100 "缓存查找时间" #### 文件系统断言 **文件存在：** 断言文件存在（）{ 本地文件=“$1” local message="${2:-文件应该存在}" 如果 [ -f "$file" ];然后传递“$消息：$文件” 否则失败“$消息：$文件未找到” 菲 } 断言_目录_存在（）{ 本地目录=“$1” local message="${2:-目录应该存在}" 如果[-d“$dir”];然后传递“$消息：$dir” 否则失败“$message：未找到$dir” 菲 } # 用法 assert_file_exists "$HOME/.goto_index" "已创建缓存文件" **文件内容断言：** 断言文件包含（）{ 本地文件=“$1” 本地模式=“$2” local message="${3:-文件应包含模式}" if grep -q "$pattern" "$file" 2>/dev/null;然后传递“$消息” 否则失败“$message：在$file中找不到模式'$pattern'” 菲 } 断言行数（）{ 本地文件=“$1” 本地预期=$2 local message="${3:-文件应该有预期的行数}" 本地实际=$(wc -l < "$file" | tr -d ' ') 如果 [ $实际 -eq $预期 ];然后通过“$消息：$实际行” 否则失败“$message：预期$expected行，得到$actual” 菲 } # 用法 assert_file_contains“$HOME/.goto_bookmarks”“工作|/路径/到/工作” assert_line_count "$HOME/.goto_history" 10 #### 输出断言 **包含图案：** 断言_输出_包含（）{ 本地输出=“$1” 本地模式=“$2” local message="${3:-输出应包含模式}" if [[ "$output" =~ $pattern ]];然后传递“$消息” 否则失败“$message：在输出中找不到模式'$pattern'” 菲 } # 用法输出=$(转到最近) assert_output_contains "$output" "/Users/manu/work" "最近显示工作目录" **空输出：** 断言_输出_空（）{ 本地输出=“$1” local message="${2:-输出应为空}" 如果 [[ -z "$output" ]];然后传递“$消息” 否则失败“$message：得到'$output'” 菲 } # 用法输出=$(转到不存在的2>&1) 断言_输出_空“$输出” ### 测试辅助函数创建可重用的测试助手库： #!/bin/bash # test-helpers.sh - 可重用的测试实用程序 #============================================== # 设置/拆卸 #============================================== setup_test_env() { # 创建临时目录用于测试 TEST_TEMP_DIR=$(mktemp -d) # 备份真实文件 [ -f "$HOME/.goto_index" ] && cp "$HOME/.goto_index" "$TEST_TEMP_DIR/goto_index.bak" [ -f "$HOME/.goto_bookmarks" ] && cp "$HOME/.goto_bookmarks" "$TEST_TEMP_DIR/goto_bookmarks.bak" [ -f "$HOME/.goto_history" ] && cp "$HOME/.goto_history" "$TEST_TEMP_DIR/goto_history.bak" } 拆解测试环境（）{ # 恢复备份 [ -f "$TEST_TEMP_DIR/goto_index.bak" ] && mv "$TEST_TEMP_DIR/goto_index.bak" "$HOME/.goto_index" [ -f "$TEST_TEMP_DIR/goto_bookmarks.bak" ] && mv "$TEST_TEMP_DIR/goto_bookmarks.bak" "$HOME/.goto_bookmarks" [ -f "$TEST_TEMP_DIR/goto_history.bak" ] && mv "$TEST_TEMP_DIR/goto_history.bak" "$HOME/.goto_history" # 删除临时目录 rm -rf“$TEST_TEMP_DIR” } #============================================== # 测试数据创建 #============================================== 创建_测试_缓存（）{ 本地条目=“${1:-10}” 本地cache_file =“$ HOME / .goto_index” 猫 > "$cache_file" << EOF # unix-goto 文件夹索引缓存 # 版本：1.0 # 建成：$(日期 +%s) # 深度：3 # 格式：文件夹名称|完整路径|深度|最后修改时间 #--- EOF for i in $(seq 1 $entries);做 echo "文件夹-$i|/path/to/folder-$i|2|$(日期 +%s)" >> "$cache_file" 完成 } 创建测试书签（）{ 本地计数=“${1:-5}” 本地 bookmark_file="$HOME/.goto_bookmarks" rm -f "$bookmark_file" for i in $(seq 1 $count);做 echo "bookmark$i|/path/to/bookmark$i|$(date +%s)" >> "$bookmark_file" 完成 } 创建_测试_历史记录（）{ 本地计数=“${1:-20}” 本地history_file =“$HOME/.goto_history” rm -f "$history_file" for i in $(seq 1 $count);做 echo "$(date +%s)|/path/to/dir$i" >> "$history_file" 完成 } #============================================== # 计时实用程序 #============================================== time_function_ms() { 本地函数=“$1” 转变本地参数=“$@” 本地开始=$(日期+%s%N) $func $args 本地端=$(日期+%s%N) 回声$(((结束-开始)/1000000)) } #============================================== # 断言助手 #============================================== 断言函数存在（）{ 本地函数=“$1” 如果声明 -f "$func" > /dev/null;然后通过“函数$func存在” 否则失败“未找到函数 $func” 菲 } 断言变量集（）{ 本地变量=“$1” 如果 [ -n "${!var}" ];然后通过“变量 $var 已设置” 否则失败“变量 $var 未设置” 菲 } ## 示例 ### 示例 1：完整的缓存测试套件 #!/bin/bash # test-cache.sh - 综合缓存系统测试套件设置-e SCRIPT_DIR="$(cd "$(目录名 "$0")" && pwd)" 源“$SCRIPT_DIR/lib/cache-index.sh” 源“$SCRIPT_DIR/test-helpers.sh” 测试通过=0 测试失败=0 pass() { echo "✓ PASS: $1"; ((测试通过++)); } 失败() { echo "✗ 失败: $1"; ((测试失败++)); } #============================================== # 单元测试 #============================================== 回显“单元测试” 回声“──────────────────────────────────────────” test_cache_lookup_single_match() { 设置_测试_环境 # 安排猫 > "$HOME/.goto_index" << EOF # unix-goto 文件夹索引缓存 #--- unix-goto|/用户/manu/Git_Repos/unix-goto|2|1234567890 EOF # 行动本地结果=$(__goto_cache_lookup "unix-goto") 本地退出代码=$? # 断言 if [[ "$result" == "/Users/manu/Git_Repos/unix-goto" && $exit_code -eq 0 ]];然后通过“单位：单次匹配查找” 否则失败“单位：单个匹配查找 - 得到'$result'代码$exit_code” 菲拆解测试环境 } test_cache_lookup_not_found() { 设置_测试_环境 # 安排创建测试缓存 5 # 行动本地结果=$(__goto_cache_lookup "不存在") 本地退出代码=$? # 断言 if [[ -z "$result" && $exit_code -eq 1 ]];然后通过“单位：未找到返回代码 1” 否则失败“单位：未找到 - 获取 '$result' 代码 $exit_code” 菲拆解测试环境 } test_cache_lookup_multiple_matches() { 设置_测试_环境 # 安排猫 > "$HOME/.goto_index" << EOF # unix-goto 文件夹索引缓存 #--- 项目|/用户/manu/project1|2|1234567890 项目|/用户/manu/project2|2|1234567891 EOF # 行动本地结果=$(__goto_cache_lookup“项目”) 本地退出代码=$? 本地 line_count=$(echo "$result" | wc -l | tr -d ' ') # 断言 if [[ $line_count -eq 2 && $exit_code -eq 2 ]];然后 pass “单位：多个匹配返回代码 2” 否则失败“单元：多个匹配 - 获取 $line_count 行代码 $exit_code” 菲拆解测试环境 } #============================================== # 集成测试 #============================================== 回声“” echo“集成测试” 回声“──────────────────────────────────────────” test_cache_build_and_lookup() { 设置_测试_环境 # 安排 rm -f "$HOME/.goto_index" # 行动 __goto_cache_build 本地构建代码=$? 本地结果=$(__goto_cache_lookup "unix-goto") 本地查找代码=$? # 断言 if [[ $build_code -eq 0 && $lookup_code -eq 0 && -n "$result" ]];然后通过“集成：构建和查找” 否则失败“集成：构建（$build_code）和查找（$lookup_code）失败” 菲拆解测试环境 } #============================================== # 边缘情况 #============================================== 回声“” echo“边缘情况测试” 回声“──────────────────────────────────────────” 测试_空_缓存_文件（）{ 设置_测试_环境 # 安排触摸“$HOME/.goto_index” # 行动本地结果=$(__goto_cache_lookup“任何内容”) 本地退出代码=$? # 断言 if [[ -z "$result" && $exit_code -eq 1 ]];然后通过“边缘：已处理空缓存” 否则失败“Edge：空缓存应返回代码 1” 菲拆解测试环境 } 测试特殊字符（）{ 设置_测试_环境 # 安排猫 > "$HOME/.goto_index" << EOF # unix-goto 文件夹索引缓存 #--- my-project_v2.0|/Users/manu/my-project_v2.0|2|1234567890 EOF # 行动本地结果=$(__goto_cache_lookup“my-project_v2.0”) 本地退出代码=$? # 断言 if [[ "$result" == "/Users/manu/my-project_v2.0" && $exit_code -eq 0 ]];然后通过“边缘：名称中的特殊字符” 否则失败“边缘：特殊字符失败” 菲拆解测试环境 } #============================================== # 性能测试 #============================================== 回声“” echo“性能测试” 回声“──────────────────────────────────────────” 测试缓存查找速度（）{ 设置_测试_环境 # 安排创建测试缓存 100 # 行动本地持续时间=$(time_function_ms __goto_cache_lookup“folder-50”) # 断言 - 应<100ms 如果 [ $duration -lt 100 ];然后通过“性能：缓存查找 ${duration}ms（<100ms 目标）” 否则失败“性能：缓存太慢${duration}ms” 菲拆解测试环境 } 测试缓存构建速度（）{ 设置_测试_环境 # 安排 rm -f "$HOME/.goto_index" # 行动本地持续时间=$(time_function_ms __goto_cache_build) # 断言 - 应 <5000 毫秒（5 秒）如果 [ $duration -lt 5000 ];然后通过“性能：缓存构建 ${duration}ms（<5000ms 目标）” 否则失败“性能：缓存构建太慢${duration}ms” 菲拆解测试环境 } #============================================== # 运行所有测试 #============================================== test_cache_lookup_single_match test_cache_lookup_not_found test_cache_lookup_multiple_matches 测试缓存构建和查找测试_空_缓存_文件测试特殊字符测试缓存查找速度测试缓存构建速度 #============================================== # 总结 #============================================== 回声“” 回声“═══════════════════ ════════════════════》 echo“测试通过：$TESTS_PASSED” echo“测试失败：$TESTS_FAILED” echo“覆盖率：100%（测试了所有代码路径）” 回声“═══════════════════ ════════════════════》 [ $TESTS_FAILED -eq 0 ] && 退出 0 || 1号出口 ### 示例 2：基准测试套件 #!/bin/bash # test-benchmark.sh - 基准功能测试套件设置-e SCRIPT_DIR="$(cd "$(目录名 "$0")" && pwd)" 源“$SCRIPT_DIR/benchmarks/bench-helpers.sh” 测试通过=0 测试失败=0 pass() { echo "✓ PASS: $1"; ((测试通过++)); } 失败() { echo "✗ 失败: $1"; ((测试失败++)); } # 单元测试 test_bench_time_ms() { # 安排本地cmd =“睡眠0.1” # 行动本地持续时间=$(bench_time_ms $cmd) # 断言 - 应该约为 100 毫秒如果 [ $duration -ge 90 ] && [ $duration -le 150 ];然后通过“bench_time_ms 正确测量：${duration}ms” 否则失败“bench_time_ms 不准确：${duration}ms（预计约 100ms）” 菲 } test_bench_calculate_stats() { # 安排本地值=(10 20 30 40 50) # 行动本地统计=$(bench_calculate_stats "${values[@]}") IFS=',' 读取 -r 最小最大平均中位数 stddev <<< "$stats" # 断言如果[[ $min -eq 10 && $max -eq 50 && $mean -eq 30 ]];然后通过“bench_calculate_stats 正确计算” 否则失败“统计计算失败：min=$min max=$maxmean=$mean” 菲 } test_bench_create_workspace() { # 安排/行动本地工作空间=$(bench_create_workspace“小”) # 断言 if [ -d "$workspace" ] && [ $(ls -1 "$workspace" | wc -l) -eq 10 ];然后通过“工作空间创建（小：10个文件夹）” bench_cleanup_workspace“$工作空间” 否则失败“工作区创建失败” 菲 } # 运行测试测试台时间毫秒测试台计算统计测试台创建工作空间回声“” echo“测试通过：$TESTS_PASSED” echo“测试失败：$TESTS_FAILED” [ $TESTS_FAILED -eq 0 ] && 退出 0 || 1号出口 ## 最佳实践 ### 测试组织 **文件命名约定：** test-cache.sh # 测试缓存系统 test-bookmark.sh # 测试书签 test-navigation.sh # 测试导航 test-benchmark.sh # 测试基准 **测试函数命名：** 测试_[类别]_[功能]_[场景] 示例： test_unit_cache_lookup_single_match test_integration_navigation_with_cache 测试边空输入测试性能缓存速度 ### 测试独立性每个测试必须完全独立： # 好 - 独立测试测试特征（）{ # 设置自己的环境本地温度=$(mktemp) # 测试结果=$(测试下的函数) # 清理自身资源 rm -f“$temp” # 断言 [[ "$result" == "expected" ]] && 通过“测试” || “测试”失败 } # 不好 - 取决于之前的测试状态测试特征坏（）{ # 假设之前测试中的一些内容 result=$(function_under_test) # 如果单独运行可能会失败 } ### 有意义的失败消息 # 好 - 详细的失败消息 if [[ "$结果" != "$预期" ]];然后失败“缓存查找失败：预期'$expected'，得到'$result'，退出代码：$exit_code” 菲 # 不好 - 模糊的失败消息 if [[ "$结果" != "$预期" ]];然后失败“测试失败” 菲 ### 测试执行速度保持快速测试： * 单元测试：每个 <1ms * 集成测试：每次<100ms * 边缘情况：每种<10ms * 性能测试：根据测量需要整个测试套件应在 <5 秒内运行。 ## 快速参考 ### 测试模板清单 * Shebang 和 set -e * 源所需模块 * 初始化测试计数器 * 定义通过/失败助手 * 按类别组织测试 * 使用排列-行为-断言模式 * 打印带有退出代码的摘要 ### 覆盖范围清单 * 所有公共函数都经过测试 * 执行所有代码路径 * 所有返回码均已验证 * 测试所有错误条件 * 涵盖所有边缘情况 * 绩效目标已验证 ### 基本测试命令 # 运行单个测试套件 bash 测试缓存.sh # 运行所有测试 bash test-cache.sh && bash test-bookmark.sh && bash test-navigation.sh # 以详细输出运行设置-x； bash 测试缓存.sh；设置+x # 运行特定的测试函数 bash -c '源测试缓存.sh; test_cache_lookup_single_match' ** ** **技能版本：** 1.0 **最后更新：** 2025 年 10 月 **维护者：** Manu Tej + Claude Code **来源：** unix-goto 测试模式和方法

Shell 测试框架

包含技能