在 PyCharm 中可以正常跳转（即 IDE 能识别模块），但在运行时却提示 `ModuleNotFoundError`，这是一个常见的 Python 模块路径问题。虽然 PyCharm 会自动将当前项目根目录加入 `sys.path`，但直接通过命令行运行脚本时并不会自动这么做。 --- ### ✅ 问题分析 #### 示例结构： ``` project_root/ ├── src/ │ └── generated/ │ └── lemon_fut_pb2.py ├── main.py ``` - 在 PyCharm 中运行 `main.py`：IDE 自动把 `project_root/` 加入 `sys.path`，所以能识别 `src/generated/lemon_fut_pb2.py` - 命令行运行 `python main.py`：Python 默认只把当前脚本所在目录和系统路径加入 `sys.path`，无法找到 `lemon_fut_pb2` --- ### ✅ 解决方案 #### 方法一：设置 PYTHONPATH 环境变量（推荐） 在运行脚本前设置环境变量，让 Python 找到你的模块路径： ```bash export PYTHONPATH=$(pwd)/src:$PYTHONPATH python main.py ``` > 这样做的效果是告诉 Python，在导入模块时也去 `src/` 目录下查找。 --- #### 方法二：动态添加路径到 sys.path（调试用） 在 `main.py` 文件顶部加上如下代码： ```python import sys from pathlib import Path # 将 src 添加到 sys.path sys.path.append(str(Path(__file__).parent / "src")) import generated.lemon_fut_pb2 as lemon_fut_pb2 ``` ⚠️ 注意：这种方式适合临时调试，不建议用于生产或打包部署。 --- #### 方法三：使用包结构 + 安装本地模块（推荐用于长期开发） 创建一个 `setup.py` 文件： ```python # setup.py from setuptools import setup, find_packages setup( name="my_proto_modules", version="0.1", packages=find_packages(), package_dir={"": "src"}, ) ``` 然后安装为本地开发包： ```bash pip install -e . ``` 之后你就可以像标准库一样导入： ```python import generated.lemon_fut_pb2 as lemon_fut_pb2 ``` --- ### ✅ 总结 | 方法 | 是否推荐 | 说明 | |------|----------|------| | 设置 PYTHONPATH | ✅ 推荐 | 快速、适用于脚本执行 | | 修改 sys.path | ⚠️ 不推荐 | 只适合调试 | | 使用 setup.py 安装 | ✅✅ 强烈推荐 | 更规范、适合长期维护 | --- ###