VS Code中Python跨模块导入失败，PyCharm正常的问题求助

目录结构确认 #

你的项目结构（已添加__init__.py后）应为：

主项目目录/
├── db/
│   ├── __init__.py
│   ├── connectdb.py
│   └── app.db
└── model/
    ├── __init__.py
    └── task.py

问题原因 #

PyCharm会自动把项目根目录加入Python的sys.path，所以能正常识别模块；但直接运行task.py时，Python默认将脚本所在的model目录作为路径起点，找不到db模块；相对导入报错是因为直接运行脚本时，它被当作顶层脚本，没有父包上下文。

解决方案 #

方案1：临时将项目根目录加入路径 #

在task.py开头添加代码，手动把项目根目录加入sys.path：

import sys
import os

# 获取项目根目录（model文件夹的父目录）
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
if project_root not in sys.path:
    sys.path.append(project_root)

from db.connectdb import ConnectDb

# 后续代码保持不变
class Tasks():
    def __init__(self):
        self.db = ConnectDb().get_connection()

    def get_all_tasks(self):
        return self.db.execute("Select * from tasks").fetchall()


t = Tasks()
print(t.get_all_tasks())

方案2：以模块方式运行脚本 #

打开终端，切换到主项目目录，执行以下命令：

python -m model.task

这种方式会把主项目目录当作包的根目录，同时支持绝对导入（from db.connectdb import ConnectDb）和相对导入（from ..db.connectdb import ConnectDb）。

方案3：永久设置PYTHONPATH环境变量 #

把主项目目录路径添加到PYTHONPATH，让Python全局识别该项目的模块：

• Windows：
  打开命令提示符执行临时设置：

  set PYTHONPATH=你的主项目目录路径;%PYTHONPATH%
  

  永久设置：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→新建系统变量PYTHONPATH，填入项目根目录路径。
• Linux/macOS：
  打开终端执行临时设置：

  export PYTHONPATH="/你的主项目目录路径:$PYTHONPATH"
  

  永久生效：将上述命令添加到~/.bashrc或~/.zshrc文件末尾，保存后执行source ~/.bashrc（或对应配置文件）。

内容的提问来源于stack exchange，提问作者B.oualid