答案是：doctest可通过testfile()函数从独立文件运行测试，保持源码整洁。创建如my_module_test.txt的文本文件，包含>>>开头的交互式样例；用doctest.testfile()加载并执行，推荐将测试文件放入tests目录，通过os.path.join处理路径，确保导入正确且输出完全匹配，适合测试内容多时的项目结构管理。
在 Python 中，doctest 可以从源代码中移出，放到独立的文件中进行管理。这样做有助于保持源码整洁，尤其适合文档测试内容较多的情况。
基本原理
doctest 模块支持从外部文本文件中加载并运行测试。这些文件可以是纯文本格式，包含交互式 Python 会话的样例（即以 >>> 开头的代码行和对应的输出）。
1. 创建独立的 doctest 文件
新建一个文本文件，例如 my_module_test.txt，内容如下：
立即学习“Python免费学习笔记（深入）”；
函数示例说明 >>> from my_module import add >>> add(2, 3) 5字符串拼接 >>> from my_module import greet >>> greet("Alice") 'Hello, Alice'
注意：文件中不需要写 if name == 'main'，只需要模拟交互式解释器的内容即可。
2. 在代码中加载外部 doctest 文件
使用 doctest.testfile() 函数来运行独立的测试文件：
艺帆网络工作室网站源码1.7.5
下载
艺帆网络工作室网站源码,是国庆后新一批新概念的网站源码,采用流行的Html5和JS组合流畅顺滑，界面清晰明朗，适合科技类企业和公司建站使用。如果你是想成为一家独特的设计公司，拥有独特的文化，追求品质，而非数量与规模。 这种坚持一直贯穿于项目运作之中，从品牌建立、形象推广设计到品牌形象管理。那可以考虑使用这款艺帆网络工作室网站源码。 这款源码中服务项目和团队程序需要在_template文件夹下的in
# test_runner.py
import doctest
if __name__ == '__main__':
doctest.testfile('my_module_test.txt', verbose=True)运行这个脚本就会执行 my_module_test.txt 中的所有测试。
常见参数：
-
verbose=True：显示详细执行过程 -
module_relative=False：若测试文件在模块路径外，可设为 False 并用相对或绝对路径 -
encoding='utf-8'：指定文件编码
3. 推荐项目结构
将测试文件组织到专门目录中，例如：
project/ │ ├── my_module.py ├── tests/ │ └── my_module_test.txt └── run_tests.py
在 run_tests.py 中：
import doctest
import os
if __name__ == '__main__':
test_file = os.path.join('tests', 'my_module_test.txt')
doctest.testfile(test_file, module_relative=False, verbose=True)4. 注意事项
确保独立测试文件中的导入语句正确，能访问到被测函数。
- 测试文件中的代码像真实交互一样运行，所以需要显式导入模块
- 路径问题要处理好，建议使用相对路径配合
os.path.join或pathlib - 输出必须完全匹配，包括引号、空格和换行
基本上就这些。用独立文件管理 doctest 能让文档测试更清晰，也方便协作维护。
