# 本地 TMS

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

本地 TMS 是一种轻量且敏捷的方式来存储和管理您的测试数据，适用于任何规模的团队。 本地 TMS 将测试数据存储为项目中的  `t.md`  和  `r.md`  文件的集合。 这种方法支持分支、版本控制、审阅，并且与自动化测试更好地集成。

观看这段简短的视频，了解本地 TMS 的工作原理：

[Video](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_local_tms.mp4)

> **Warning:**
> 本地 TMS 格式处于试验阶段，没有规范，因此将来版本可能会有所更改。

Procedure: 启用本地 TMS

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `工具 | TMS` 。

2. 请选中   Markdown   复选框下的   TMS  。

如果您的项目中已经有任何  `t.md` 文件，它们将显示在   Markdown  选项卡的   TMS  工具窗口中。

Procedure: 创建测试套件

1. 在   项目  工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))中，选择您想创建测试套件的目录，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))，然后从菜单中选择   测试套件  。

或者，右键点击该目录并选择  `新建 | 新建测试套件` 。

2. 为测试套件命名并按下 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))。

测试套件文件具有以下格式：

```
# MyTestSuite
Tags: tag1, tag2
Meta: key1 = value, key2 = value

## S1 Sub-suite 1
* C1 Test Case 1
Tags: tag3
    * Step 1
    * Step 2
* C2 Test Case 2
Tags: tag4
    * Step 1
    * Step 2

## S2 Sub-suite 2
* C3 Test Case 3
Tags: tag5
    * Step 1
    * Step 2

```

* 标题包含测试套件名称。

* 标签和元数据在元素声明之后，使用 `标签` 和 `Meta` 关键字指定。 然后可以使用标签和元数据作为过滤 TMS 项目的标准。

* 每个元素（suite、sub-suite 和 case）都可以拥有自己的标签和元数据。

* 标签和元数据从套件或子套件继承到其相应的测试用例。 继承的标签和元数据显示在测试用例的 TMS 工具窗口中。 ![继承的标签和元数据](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_tags_metadata_visibility.png)

* 列表项是测试用例。

* 字母 `S` 和 `C` 后接数字表示分配给测试套件或用例的 ID。 建议为测试用例分配一个 ID，测试套件则是可选的。

* 嵌套列表项是测试步骤。

> **Note:**
> 在给测试套件或案例分配 ID 时，请仅指定数字。 相应的字母会自动添加。

![为测试套件和用例分配 ID](https://resources.jetbrains.com.cn/help/img/idea/2026.3/aqua_test_suites_and_cases.animated.gif)

> **Tip:**
> 重命名重构 `Shift+F6` (Windows), `⇧ F6` (macOS), `⇧ F6` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ R` (macOS System Shortcuts), `Shift+F6` (XWin), `Shift+F6` (GNOME), `Shift+F6` (KDE), `Shift+F6` (Emacs), `Shift+F6` (Sublime Text), `⇧ F6` (Sublime Text (macOS)), `Ctrl+R, R` (Visual Studio), `⌘ R, R` (Visual Studio (macOS)), `Ctrl+R` (NetBeans), `Alt+Shift+R` (Eclipse), `⇧ F6` (Eclipse (macOS))和查找用法 `Alt+F7` (Windows), `⌥ F7` (macOS), `⌥ F7` (IntelliJ IDEA Classic (macOS)), `⌃ U` (macOS System Shortcuts), `Alt+F7` (XWin), `Alt+Shift+7` (GNOME), `Alt+Shift+7` (KDE), `Alt+F7` (Emacs), `Alt+F7` (Sublime Text), `⌥ F7` (Sublime Text (macOS)), `Shift+F12` (Visual Studio), `⇧ F12` (Visual Studio (macOS)), `Alt+F7` (NetBeans), `Ctrl+G` (Eclipse), `⌘ ⇧ G` (Eclipse (macOS))适用于本地 TMS 文件中的所有标识符和元数据。 例如，当您想要一致地重命名可能在其他地方使用的元素，或快速查找测试状态、用户 id、标签等的出现次数时，这非常有用。

Procedure: 创建测试运行

测试运行作为您项目的一部分存储在  `r.md` 文件中。 它们不需要对应一个测试用例，可以由任意步骤组成。

1. 在   项目  工具窗口 `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))中，选择您要创建测试运行的目录，按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))并从菜单中选择   测试运行  。

或者，右键点击该目录并选择  `新建 | 新建测试运行` 。

2. 请选择在此次测试中应检查的测试用例。

Procedure: 管理测试运行

对于每个测试运行中的测试用例，您可以指定其结果以及谁执行了测试。

1. 请移至测试运行文件。

2. 请指定结果，例如，  `[ok]`  或  `[fail]`  和 agent id，使用  `@`  标志，例如：

```
* [ok] @my.user Test Case 1
```

## 通过 VCS 共享测试数据

存储在本地 TMS 中的测试数据可以像其他项目文件一样共享和版本化。

有关在项目中启用和使用版本控制的更多信息，请参阅 [版本控制](version-control-integration.html) 主题。