在 Python 代码中使用相对路径时，主要依赖于模块的导入机制，尤其是相对导入（relative imports）和当前脚本的执行上下文。相对路径通常用于包（package）内部模块之间的导入，其核心在于理解模块的 `__name__` 属性以及包结构的定义。 在具有明确包结构的模块中，可以使用相对导入来引用同包内的其他模块。相对导入使用点（`.`）表示当前模块，两个点（`..`）表示上一级模块，以此类推。相对导入仅适用于包中的模块，这意味着模块文件夹中必须包含 `__init__.py` 文件（即使为空文件）以标识其为包[^4]。 例如，假设项目结构如下： ``` my_package/ ├── __init__.py ├── module_a.py └── subpackage/ ├── __init__.py └── module_b.py ``` 在 `module_b.py` 中，可以使用以下方式导入 `module_a.py`： ```python from .. import module_a ``` 这种导入方式表明 `module_a` 是 `subpackage` 的上一级包中的模块。 需要注意的是，相对导入不能在顶层模块中使用。所谓顶层模块，是指以 `__main__` 作为 `__name__` 的模块，即直接运行的脚本。在这种情况下，尝试使用相对导入会导致 `ValueError: attempted relative import in non-package` 错误。为了避免此类问题，建议将主要逻辑封装在函数或类中，并通过入口脚本调用，而不是直接在模块中执行代码[^4]。 此外，Python 的模块搜索路径（`sys.path`）也会影响模块的导入行为。在某些情况下，可能需要动态地修改 `sys.path` 来包含额外的目录，以便能够正确解析模块路径。但是，这种做法应当谨慎使用，因为不当的路径修改可能导致模块导入混乱。如果确实需要调整路径，建议在代码中显式地添加必要的目录，并确保这些目录的添加逻辑集中管理，以便于维护和调试[^3]。 ### 示例代码 假设我们有一个简单的包结构，如下所示： ``` project_root/ ├── main.py └── my_package/ ├── __init__.py ├── config.py └── utils/ ├── __init__.py └── helper.py ``` 如果我们想在 `helper.py` 中导入 `config.py`，可以使用以下相对导入语句： ```python from .. import config ``` 这样就可以访问 `config.py` 中定义的变量或函数。 如果我们在 `main.py` 中想要运行 `helper.py` 中的代码，不能直接运行 `helper.py`，而应该通过 `my_package.utils.helper` 的方式来执行，例如： ```bash python -m my_package.utils.helper ``` 这种方式确保了 Python 解释器能够正确识别包结构，并允许相对导入正常工作。