遇到的问题
解决 Python 模块导入路径问题
问题描述
在运行 Python 文件时，可能会遇到以下错误：
ModuleNotFoundError: No module named 'utils'
原因：
- Python 的模块导入机制依赖于当前工作目录和
sys.path中的路径。 - 当直接运行某个文件时，Python 会将该文件所在目录添加到
sys.path，而不是项目的根目录，导致无法正确导入其他模块。
解决方法 (一般再临时调试时候会出现，我推荐使用方法三）
方法 1：修改 sys.path
在代码中手动将项目的根目录添加到 sys.path：
import sys
import os
current_dir = os.path.dirname(os.path.abspath(__file__))
project_root = os.path.abspath(os.path.join(current_dir, '..'))
if project_root not in sys.path:
sys.path.append(project_root)
from utils.subgraph_extraction import *
优点：简单直接，适合快速调试。
缺点：不够优雅，可能不适合复杂项目。
方法 2：使用相对导入
如果项目是一个包（包含 __init__.py），可以使用相对导入：
from ..utils.subgraph_extraction import *
然后从项目的根目录运行脚本：
python -m utils.Core_functions
优点：符合 Python 包管理规范，适合大型项目。
缺点：不能直接运行单个文件，需要调整运行方式。
方法 3：设置环境变量 PYTHONPATH
在运行脚本前，设置环境变量 PYTHONPATH 指向项目的根目录。
比如这样，我原本再根目录调用这个文件，没有问题，但是现在我想要进入这个文件里面运行它
就会报错：
这样再运行就没问题了
- Linux/MacOS：
export PYTHONPATH=/path/to/your/project python utils/Core_functions.py - Windows（命令提示符）：
set PYTHONPATH=C:\path\to\your\project python utils\Core_functions.py - Windows（PowerShell）：
$env:PYTHONPATH = "C:\path\to\your\project" python utils\Core_functions.py
优点：无需修改代码，适合团队协作。
缺点：需要每次运行前设置环境变量。
方法 4：使用 IDE 配置工作目录
通过 IDE 配置运行时的工作目录为项目的根目录。
-
PyCharm：
- 打开运行配置（Run/Debug Configurations）。
- 设置
Working Directory为项目的根目录。
-
VSCode：
在.vscode/launch.json中添加以下配置：{ "version": "0.2.0", "configurations": [ { "name": "Run Core_functions", "type": "python", "request": "launch", "program": "utils/Core_functions.py", "cwd": "${workspaceFolder}" } ] }
优点：适合开发环境，无需修改代码。
缺点：仅适用于特定 IDE。
方法 5：重构项目结构
将所有模块组织为一个包，并通过入口脚本（如 main.py）统一调用。例如：
project/
├── main.py
├── utils/
│ ├── __init__.py
│ ├── Core_functions.py
│ └── subgraph_extraction.py
在 main.py 中：
from utils.Core_functions import some_function
if __name__ == "__main__":
some_function()
然后始终通过 main.py 运行项目：
python main.py
优点：规范项目结构，避免路径问题。
缺点：需要对项目进行一定的重构。
总结
- 临时调试：推荐 方法 1 或 方法 3。
- 长期维护：推荐 方法 2 或 方法 5。
- IDE 开发：推荐 方法 4。
根据具体需求选择合适的方法即可！
