VSCode调试Python测试时导入functions模块失败求助

你的项目结构：

a/b/c/d/service/functions/s3_proxy.py
a/b/c/d/service/functions/__init__.py

a/b/c/d/service/tests/test_s3_proxy.py
a/b/c/d/service/tests/__init__.py

在test_s3_proxy.py里导入失败，试试这几个办法：

方法1：临时添加路径到Python搜索列表 #

在test_s3_proxy.py的最开头加上这段代码，把service目录的绝对路径加入Python搜索路径：

import sys
from pathlib import Path

# 获取当前文件所在目录的父目录（即service目录）
service_dir = Path(__file__).parent.parent
sys.path.append(str(service_dir))

from functions import s3_proxy

这种方式简单直接，能快速解决调试时的导入问题。

方法2：绝对导入+配置VSCode调试环境 #

把导入语句改成绝对导入格式：

from service.functions import s3_proxy

然后需要让Python能找到service所在的父目录（即a/b/c/d），在VSCode里这么配置：

1. 打开.vscode/launch.json（没有的话直接新建）
2. 在调试配置项中添加env字段，设置PYTHONPATH为a/b/c/d的绝对路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "env": {
                "PYTHONPATH": "/绝对路径/to/a/b/c/d"
            }
        }
    ]
}

调试时Python会自动把指定路径加入搜索列表，就能识别service包了。

方法3：配置VSCode工作区分析路径 #

这个设置主要解决VSCode代码提示报错的问题，配合方法2的绝对导入使用：

1. 打开VSCode设置（快捷键Ctrl+,）
2. 搜索Python › Analysis: Extra Paths
3. 点击编辑 in settings.json，添加a/b/c/d的绝对路径：

{
    "python.analysis.extraPaths": [
        "/绝对路径/to/a/b/c/d"
    ]
}

另外，之前用from ..functions import s3_proxy的相对导入失败，是因为直接运行测试文件时，Python会把它当成独立脚本而非包的一部分，相对导入仅在包内部模块间生效。如果非要用相对导入，得从a/b/c/d目录执行python -m service.tests.test_s3_proxy，同时在VSCode里把运行目录设置为a/b/c/d。

内容的提问来源于stack exchange，提问作者AfterWorkGuinness