如何在 Python 中跨驱动器和目录结构正确导入模块-Python教程-PHP中文网

如何在 Python 中跨驱动器和目录结构正确导入模块

本文详解 Python 跨目录（包括不同磁盘驱动器）导入模块的规范方法，重点解决因缺失包结构导致的 ImportError: attempted relative import with no known parent package 问题，强调通过 __init__.py 建立包层级、避免硬编码 sys.path 的工程化实践。

本文详解 python 跨目录（包括不同磁盘驱动器）导入模块的规范方法，重点解决因缺失包结构导致的 `importerror: attempted relative import with no known parent package` 问题，强调通过 `__init__.py` 建立包层级、避免硬编码 `sys.path` 的工程化实践。

Python 的模块导入机制本质上依赖于包（package）结构和执行上下文，而非单纯的文件路径拼接。您遇到的错误 ImportError: attempted relative import with no known parent package 并非路径不可达，而是 Python 解释器无法将 B.py 识别为一个包内的模块——因为相对导入（如 from ..fC.C import func）仅在模块作为包的一部分被以包方式导入时才有效，而直接运行 .py 文件或通过 sys.path 简单添加路径，会使该文件以 __main__ 或顶层模块身份加载，失去父包上下文。

要根本性解决跨驱动器（如 C:\ → Z:\）的模块复用问题，关键在于统一项目根目录并构建合规的包结构，而非依赖驱动器字母跳转。以下是推荐的工程化方案：

✅ 正确做法：将 Z 盘目录作为 Python 包纳入项目结构

假设您的实际项目逻辑上属于同一系统（例如 Z:\myproject 是主代码库），请按如下方式组织：

Z:\myproject\
├── __init__.py          # 标记 myproject 为顶层包
├── A.py                 # 可重命名为 main.py，放在项目根或单独 scripts/ 下
├── fB/
│   ├── __init__.py      # 必须存在！使 fB 成为子包
│   └── B.py             # 内容：from ..fC.C import func  ← 此时 .. 指向 myproject 根
└── fC/
    ├── __init__.py      # 必须存在！使 fC 成为子包
    └── C.py             # 定义 func()

然后，在 C:\ 上运行 A.py 时，需确保 Z:\myproject 在 sys.path 开头（推荐使用 PYTHONPATH 或启动时动态插入）：

# A.py（位于 Z:\myproject\A.py，或 C:\temp\A.py）
import sys
import os
# 将 Z:\myproject 添加到搜索路径最前（确保优先加载）
sys.path.insert(0, r"Z:\myproject")

# 现在可安全进行绝对导入（推荐）或相对导入
from fB.B import some_function  # 绝对导入，清晰可靠
# 或
from fB import B
B.some_function()

⚠️ 注意：__init__.py 文件可以为空，但必须存在（Python 3.3+ 支持隐式命名空间包，但显式 __init__.py 兼容性更好、语义更明确）。

Python Testing
Python 测试速查：运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

❌ 不推荐的反模式（应避免）

在每个 .py 中反复 sys.path.append()：破坏封装性，路径硬编码，难以维护和测试；
滥用 from ..fC.C import func 在非包上下文中：相对导入只适用于 python -m package.submodule 方式运行，或模块被 import 而非直接执行；
依赖驱动器字母做路径计算：跨平台（Linux/macOS 无盘符）、CI/CD 环境下极易失效。

? 补充建议：提升可移植性

使用 pathlib 动态定位根目录（适合脚本入口）：

from pathlib import Path
import sys
# 假设 A.py 与 myproject 同级，或通过约定位置推导
ROOT = Path(__file__).resolve().parent.parent  # 向上两级到 myproject
sys.path.insert(0, str(ROOT))