---
title: "测试用例编写指南以及最佳实践 - Python Unittest"
language: "zh"
url: "https://docs.testany.io/zh/docs/test-case-writing-guidelines-and-examples-python-u/"
markdown_url: "https://docs.testany.io/zh/docs/test-case-writing-guidelines-and-examples-python-u.md"
translation: "https://docs.testany.io/en/docs/test-case-writing-guidelines-and-examples-python-u.md"
last_updated: "2026-04-21T15:45:20+08:00"
---

# 测试用例编写指南以及最佳实践 - Python Unittest

Python [unittest](https://docs.python.org/3/library/unittest.html) 是一个 Python 单元测试框架。Testany 支持这个流行的 Python 测试框架。本文档展示了如何在 Testany 中编写一个 Python unittest 测试用例。

Testany 测试用例支持的 Python 版本是 3.11.5，并兼容其他较低版本的 Python。
如果由于任何特定原因需要新的 Python 版本，请随时联系我们的客户支持。

**测试用例包 - 一个 zip 文件**

目前我们仅支持将本地 zip 文件上传到 Testany。zip 文件应遵循以下结构：

```
my-python-test.zip
├── test_api.py          ← 主测试文件（必需）
├── utils.py             ← 辅助模块（可选）
└── requirements.txt     ← 依赖列表（可选，会自动安装）
```

**注册时配置：**
- **Executor:** `Python`
- **Command:** `python -m pytest test_api.py`（或 `python test_api.py` 用于 unittest）

zip 文件需要至少包含一个文件：

1. **测试用例代码文件或文件集**，例如 `app.py`

   ```python
   import unittest
   import os

   class TestStringMethods(unittest.TestCase):

       def test_upper(self):
           test_str = os.getenv('TEST_STR')
           self.assertEqual('foo'.upper(), test_str)

       def test_isupper(self):
           self.assertTrue('FOO'.isupper())
           self.assertFalse('Foo'.isupper())

       def test_split(self):
           s = os.getenv('SPLIT_STR')
           #s = 'hello world'
           self.assertEqual(s.split(), ['hello', 'world'])
           # 检查当分隔符不是字符串时 s.split 是否失败
           with self.assertRaises(TypeError):
               s.split(2)

   if __name__ == '__main__':
       unittest.main()
   ```


> **提示**
>
> **环境变量配置**
>
> 代码中使用的环境变量（如 `TEST_STR`、`SPLIT_STR`）必须在**两处**配置：
> 1. **Test Case 详情页** → **Environment Variables** 部分：定义变量名和值
> 2. **测试脚本代码**：使用 `os.getenv('VARIABLE_NAME')` 读取值
>
> 请参阅[《管理测试用例》](https://docs.testany.io/zh/docs/managing-test-case.md)了解如何在平台上配置环境变量。


2. `requirements.txt` **文件**
   如果你的 Python 脚本使用了一些特定的库，你可以在根文件夹中创建一个 `requirements.txt` 文件，Testany 将在 Python 执行环境中自动下载这些库。
   `requirements.txt` 示例

   ```text
   requests
   ```

将所有相关文件压缩为一个 zip 文件，在这种情况下，测试用例包文件是

![](https://docs.testany.io/docs/images/zh/image-20230903-053816_4d5fbff3.png)

在成功准备 `.zip` 文件后，您将能够在 Testany 平台上注册您的测试用例。请参阅 [《管理测试用例》](https://docs.testany.io/zh/docs/managing-test-case.md) 以获取注册的分步指南。

×

## 本页术语

- [测试用例 (Test Case)](https://docs.testany.io/zh/docs/glossary.md#test-case)
- [执行器（Executor）](https://docs.testany.io/zh/docs/glossary.md#executor)
- [命令 (Command)](https://docs.testany.io/zh/docs/glossary.md#command)
- [环境 (Environment)](https://docs.testany.io/zh/docs/glossary.md#environment)
- [测试脚本 (Test Script)](https://docs.testany.io/zh/docs/glossary.md#test-script)
- [执行 (Execution)](https://docs.testany.io/zh/docs/glossary.md#execution)