如何从父包文件访问子包文件？解析VS Code与PyCharm运行差异

项目结构 #

E:.
└───Fruit
    ├───Apple
    │   ├───KashmiriApple.py
    │   └───__init__.py
    ├───Orange
    │   ├───ChennaiOrange.py
    │   └───__init__.py
    ├───main.py
    └───__init__.py

所有__init__.py文件内容为空，其他文件内容如下：

• KashmiriApple.py

def say_hi_apple():
    print("Kashmiri Apple says Hi!")

• ChennaiOrange.py

def say_hi_orange():
    print("Chennai Orange says Hi!")

• main.py（原错误版本）

import Fruit.Orange.ChennaiOrange as CO

CO.say_hi_orange()

不用sys.path的正确导入方法 #

方法1：使用相对导入修改main.py #

因为main.py属于Fruit包内的模块，可改用相对导入语法：

# 方式1：直接导入函数
from .Orange.ChennaiOrange import say_hi_orange
say_hi_orange()

# 方式2：导入模块别名
from .Orange import ChennaiOrange as CO
CO.say_hi_orange()

注意：相对导入不能直接运行main.py脚本（比如python main.py），必须将Fruit作为包的一部分运行，参考方法2。

方法2：从父目录以模块方式运行 #

打开终端，切换到E:\目录（Fruit文件夹的父目录），执行以下命令：

python -m Fruit.main

-m参数会让Python将当前目录视为包的根路径，Fruit会被识别为顶层包，从而正确导入子模块。

VS Code与PyCharm运行差异的原因 #

1. PyCharm的默认行为：
   PyCharm在运行脚本时，会自动将项目根目录（若打开Fruit文件夹，PyCharm会自动把E:\加入sys.path）添加到Python的模块搜索路径中，因此Fruit包能被正确识别，导入成功。

2. VS Code的默认行为：
   VS Code默认以脚本所在目录（E:\Fruit）作为工作目录运行，此时Python的sys.path只包含E:\Fruit，无法找到名为Fruit的顶层包（因为Fruit文件夹就在当前目录下，Python需要从父目录搜索）。

VS Code的解决方法 #

方案1：修改运行配置的工作目录 #

• 打开VS Code的「运行和调试」面板，创建或修改launch.json配置文件，添加"cwd"字段指定父目录：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: main.py",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "cwd": "${workspaceFolder}/.." // 指向Fruit的父目录E:\
        }
    ]
}

之后直接点击运行按钮即可。

方案2：切换工作区到父目录 #

关闭当前VS Code工作区，重新打开E:\文件夹作为工作区，此时运行Fruit/main.py时，Python会自动将E:\加入sys.path，导入语句可正常生效。

方案3：终端手动运行 #

在VS Code的终端中执行以下命令：

cd ..
python -m Fruit.main

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