VS Code 的 Python 测试发现机制默认无法识别嵌套子目录中的测试文件，根本原因在于 Python 导入路径缺失和包结构不完整；通过补充 __init__.py 文件、配置 python.analysis.extraPaths 并在测试中显式添加源码路径，即可可靠支持深层目录下的 unittest 自动发现。
vs code 的 python 测试发现机制默认无法识别嵌套子目录中的测试文件，根本原因在于 python 导入路径缺失和包结构不完整；通过补充 __init__.py 文件、配置 python.analysis.extrapaths 并在测试中显式添加源码路径，即可可靠支持深层目录下的 unittest 自动发现。
要使 VS Code 成功发现并运行位于 source_folder_unittests/package1_unittests/module1_test.py 这类深层嵌套路径下的单元测试，需同时满足Python 可导入性与VS Code 测试发现配置两个前提条件。
✅ 关键步骤详解
1. 补充 __init__.py 文件（激活包结构）
Python 要求所有参与导入的目录都必须是合法包——即包含 __init__.py（可为空）。请在以下目录中分别创建空的 __init__.py 文件：
-
source_folder/ -
source_folder/package1_folder/ -
source_folder/package2_folder/ -
source_folder_unittests/ -
source_folder_unittests/package1_unittests/
⚠️ 注意：仅
source_folder_unittests和其子目录需__init__.py才能让 VS Code 将其识别为可扫描的测试包；但若测试中需导入source_folder下的模块（如package1_folder.module1），则source_folder及其子包也必须有__init__.py，否则import会失败。
2. 更新 settings.json 配置
保持原有 unittestArgs 不变，并补充语言服务器路径配置，确保类型检查与自动补全正常工作：
立即学习“Python免费学习笔记（深入）”；
{
"python.testing.unittestArgs": [
"-v",
"-s",
"./source_folder_unittests/",
"-p",
"*_test.py"
],
"python.testing.pytestEnabled": false,
"python.testing.unittestEnabled": true,
"python.analysis.extraPaths": [
"./source_folder"
]
}"python.analysis.extraPaths" 告诉 Pylance/VSC Python 扩展：source_folder 是可导入的源码根目录，从而支持跳转、补全和静态分析。
3. 在测试文件中显式设置 sys.path（推荐用于跨层级导入）
由于测试位于 source_folder_unittests/...，而被测代码在 source_folder/...，相对路径较深。为确保 import package1_folder.module1 稳定生效，在 module1_test.py 开头添加路径修正逻辑：
import sys
import os
# 将 source_folder 添加到 Python 搜索路径（相对于当前测试文件）
SOURCE_ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), "../../source_folder"))
if SOURCE_ROOT not in sys.path:
sys.path.insert(0, SOURCE_ROOT)
# 现在可以安全导入被测模块
from package1_folder import module1
import unittest
class TestModule1(unittest.TestCase):
def test_something(self):
self.assertTrue(hasattr(module1, 'some_function'))? 提示：此方式比依赖
PYTHONPATH更可控、更易调试，且不受终端启动方式影响。
? 验证与故障排查
- 重启 VS Code 或点击命令面板（
Ctrl+Shift+P）→ Python: Discover Tests，观察输出面板中是否列出package1_unittests.module1_test。 - 若仍失败，打开 VS Code 的 Output → Python Test Log，查看具体报错（常见如
ImportError: No module named 'package1_folder'，说明__init__.py缺失或路径未生效）。 - 使用终端手动运行验证：
cd /your/project/root python -m unittest discover -s source_folder_unittests -p "*_test.py" -v
若命令行能跑通但 VS Code 不行，基本可定位为配置或扩展缓存问题（尝试重载窗口或清除
~/.vscode/extensions/ms-python.python/cache）。
通过以上三步，VS Code 即可稳定发现并执行任意深度子目录下的 Python 单元测试，兼顾工程规范性与开发体验。
