本文详解 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 或启动时动态插入）：
立即学习“Python免费学习笔记（深入）”；
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
# 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 兼容性更好、语义更明确）。
❌ 不推荐的反模式（应避免）
- 在每个 .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))
配置 pyproject.toml + pip install -e .：将 Z:\myproject 声明为可编辑安装的包，彻底解耦路径依赖。
IDE 配置源根（Source Root）：如 PyCharm 中将 Z:\myproject 设为 Sources，自动加入解释器路径。
总之，Python 模块系统的设计哲学是“显式优于隐式，结构优于路径”。只要建立清晰的包层级并确保入口点能正确解析包路径，跨驱动器导入不仅可行，而且健壮、可测试、易协作。
