如何让 VS Code 正确发现并运行嵌套子目录中的 Python 单元测试-图灵python

VS Code 的 Python 默认情况下，测试框架无法识别未正确导入的子目录下的测试文件，需要添加 __init__.py 文件、配置 python.analysis.extraPaths 并调整模块导入路径。

vs code 的 python 默认情况下，测试框架无法识别未正确导入的子目录下的测试文件，需要添加 __init__.py 文件、配置 python.analysis.extrapaths 并对模块导入路径进行调整。

在 Visual Studio Code 中使用 unittest 如果测试文件(如框架) module1_test.py）位于多层嵌套子目录中，例如 source_folder_unittests/package1_unittests/）中，VS Code 即使配置正确，这些测试也不能自动发现和运行—— unittestArgs。根本原因不是 VS Code 相反，限制本身 Python 模块导入机制：必须能够测试文件 Python 解释器成功导入，测试发现器可以识别其内部 TestCase 类。

要解决这个问题，需要同时满足三个条件:

✅ 1. 确保所有相关目录合法 Python 包在以下每个目录中创建空空 __init__.py 文件(可以是空的)：

source_folder/
source_folder/package1_folder/
source_folder/package2_folder/
source_folder_unittests/
source_folder_unittests/package1_unittests/

这使 Python 将这些目录识别为可导入包，以避免 ImportError。

✅ 2. 源码路径(推荐方法)显式添加到测试文件中在 source_folder_unittests/package1_unittests/module1_test.py 在开始时添加以下代码，以确保导入待测模块：

import sys
import os

# 将 source_folder 添加到 Python 路径，使 package1_folder 等可导入
sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '../../source_folder')))

import unittest
from package1_folder.module1 import YourTestClass  # ✅ 正确导入目标模块

⚠️ 注:避免使用相对导入(如: from ..package1__folder import module1），因 unittest 可能会导致启动模式 ValueError: attempted relative import beyond top-level package。

Python数据分析助手

为业务和科研数据的快速处理提供Python数据清理、统计分析和可视化建议。

下载

立即学习“Python免费学习笔记(深入)；

✅ 3. 配置 VS Code 的 Python 分析和测试路径更新工作区或用户级 settings.json，补充 python.analysis.extraPaths(提高智能提示和静态分析)并确认测试配置:

{
    "python.testing.unittestEnabled": true,
    "python.testing.pytestEnabled": false,
    "python.testing.unittestArgs": [
        "-v",
        "-s", "./source_folder_unittests",
        "-p", "*_test.py"
    ],
    "python.analysis.extraPaths": [
        "./source_folder"
    ]
}

? 额外建议：

在运行测试前，可以通过终端执行 python -m unittest discover -s ./source_folder_unittests -p "*_test.py" -v 验证配置是否有效；
如果项目结构复杂，可以考虑统一的测试根目录(如果所有测试都放在里面 tests/ 下)，并配合 setup.py 或 pyproject.toml 配置 packages，提高可维护性；
使用 .vscode/settings.json(而非全局设置)可以保证团队环境一致。

完成上述步骤后，再次触发“Python: Discover Tests”命令（Ctrl+Shift+P → 输入 Python: Discover Tests），VS Code 深层嵌套目录下的单元测试可以稳定识别和运行。