---
title: 功能测试文档模板
doc_type: template
domain: documentation
keywords:
  - 功能测试模板
  - 验收模板
  - 文档模板
summary: 新建功能测试文档时，从这里起稿并替换占位符，统一测试范围、前提和验收步骤。
when_to_read:
  - 要新增某个功能专项的功能测试文档
  - 想统一测试文档的章节结构和验收口径
read_next:
  - ../operations/README.md
  - ./feature-template.md
---

# 功能测试文档模板

这份模板用于起草功能测试文档。使用时先改掉头部 frontmatter，再替换掉占位符、命令和设计说明链接，确保它最终落到 `operations/` 下。

## 目的

这份文档用于固定“<功能名称>”模块的功能测试方法，避免每次改动后都靠临时聊天记录回忆怎么验证。

相关设计说明见：

- [功能说明文档](../features/<feature-name>.md)

## 测试范围

当前测试范围聚焦这几个问题：

- 
- 
- 

## 测试前提

### 运行环境

- 当前仓库目录：
- 关键服务或应用标识：
- 默认数据路径：

### 关键命令

启动开发环境：

```bash
# command here
```

准备测试数据：

```bash
# command here
```

查看本地数据：

```bash
# command here
```

## 建议测试数据窗口

说明为什么选择这个数据窗口，避免空数据或偶然样本导致误判。

## 当前实现功能测试

### 1. <场景名称>

目标：

- 

步骤：

1. 
2. 
3. 

通过标准：

- 
- 

### 2. <场景名称>

目标：

- 

步骤：

1. 
2. 
3. 

通过标准：

- 
- 

## 回归检查清单

- 页面能正常进入
- 关键数据能正确落库或读取
- 关键操作不会引入回归
- 错误提示和空态符合预期
