PyCharm可运行但命令行启动Python脚本报错：找不到plotterresources模块

你的目录结构大致如下：

SwapMatrixPlotter/
├── plotterresources/
│   └── PlotterProps.py
└── possibilitiesplotter/
    ├── PossibilitiesPlotter.py
    ├── PossibilitiesGraph.py
    └── PossibilitiesModel.py

PyCharm能正常运行脚本，但命令行启动时出现ModuleNotFoundError: No module named 'plotterresources'，原因和解决方法如下：

问题根源 #

1. PyCharm默认会把项目根目录（SwapMatrixPlotter）添加到Python的模块搜索路径，所以能找到plotterresources；但命令行直接运行PossibilitiesPlotter.py时，Python只会把脚本所在的possibilitiesplotter目录加入搜索路径，找不到上层的plotterresources。
2. 你代码里的sys.path.append("plotterresources/PlotterProps.py")是错误的——Python搜索模块需要的是目录路径，不是单个文件路径，这行代码起不到任何作用。

修复方案 #

方案一：动态添加项目根目录到搜索路径（最稳妥） #

修改PossibilitiesPlotter.py里的导入代码，自动获取项目根目录并添加到sys.path：

import sys
from pathlib import Path

# 获取项目根目录（当前脚本所在目录的上一级目录）
project_root = Path(__file__).parent.parent
sys.path.append(str(project_root))

# 后续正常导入模块
from csv import reader
from plotterresources.PlotterProps import PlotterProps
from possibilitiesplotter.PossibilitiesGraph import PossibilitiesGraph
from possibilitiesplotter.PossibilitiesModel import PossibilitiesModel

class PossibilitiesPlotter:
    # 你的业务代码

这样不管你在哪个目录运行脚本，都能正确找到所有模块。

方案二：用相对导入+包模式运行 #

如果你的项目是标准Python包结构，可改用相对导入，修改导入语句：

from csv import reader
from pathlib import Path

from ..plotterresources.PlotterProps import PlotterProps
from .PossibilitiesGraph import PossibilitiesGraph
from .PossibilitiesModel import PossibilitiesModel

class PossibilitiesPlotter:
    # 你的业务代码

但这种方式需要在项目根目录下用包模式运行脚本：

python -m possibilitiesplotter.PossibilitiesPlotter

不能直接进入possibilitiesplotter目录运行python PossibilitiesPlotter.py。

方案三：临时设置PYTHONPATH环境变量 #

在命令行里先把项目根目录加入PYTHONPATH，再运行脚本：

# Windows命令行
set PYTHONPATH=C:\Users\username\PycharmProjects\SwapMatrixPlotter
python .\PossibilitiesPlotter.py

# Windows PowerShell
$env:PYTHONPATH = "C:\Users\username\PycharmProjects\SwapMatrixPlotter"
python .\PossibilitiesPlotter.py

这样后续运行该项目的脚本都不用修改代码，但每次打开新命令行都需要重新设置。

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