Python跨目录导入自定义模块失败求助（VS Code+Python3.9.13）

针对你的项目结构，直接使用from db_orm.db_interface import *无法导入的原因是Python默认只会搜索当前脚本所在目录和系统预设路径，db_orm所在的code目录不在搜索范围内。以下是几种可行的解决方法：

方法1：临时添加模块路径到sys.path #

在subpage1.py或subpage2.py的开头加入以下代码，将code目录添加到Python的搜索路径中：

import sys
from pathlib import Path

# 向上回溯三级目录找到code文件夹（subpage1.py → pages → streamlit → code）
code_directory = Path(__file__).parent.parent.parent
sys.path.append(str(code_directory))

# 现在可以正常导入模块
from db_orm.db_interface import *

这种方法无需修改环境或编辑器设置，仅针对当前脚本生效。

方法2：配置VS Code源码根目录 #

1. 打开VS Code，将code文件夹添加到工作区；
2. 在VS Code的设置中搜索python.analysis.extraPaths，添加code目录的绝对路径；
3. 或者直接在项目根目录的.vscode/settings.json中写入：

{
    "python.analysis.extraPaths": [
        "${workspaceFolder}/code"
    ]
}

配置完成后，VS Code的Python分析器和运行环境都会识别code目录下的模块，无需修改脚本代码。

方法3：设置PYTHONPATH环境变量 #

将code目录的绝对路径添加到系统的PYTHONPATH环境变量中：

• Windows：在「系统属性→高级→环境变量」中新建或编辑PYTHONPATH，添加code目录路径；
• Linux/macOS：在终端中执行export PYTHONPATH="/path/to/your/code:$PYTHONPATH"，或写入~/.bashrc/~/.zshrc文件使其永久生效。

设置完成后重启VS Code，即可直接使用from db_orm.db_interface import *导入模块。

方法4：相对导入（不推荐） #

若将code视为顶层包，可使用相对导入语法，但要求必须以包的形式运行脚本（不能直接双击或点击VS Code的运行按钮）：

from ...db_orm.db_interface import *

运行时需在code目录的上层执行：python -m code.streamlit.pages.subpage1，否则会触发"relative import beyond top-level package"错误，因此仅适合严格的包结构开发场景。

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