### 可能原因分析 PyCharm 中能够成功运行 Python 脚本而终端却无法正常执行的情况通常是由环境配置差异引起的。以下是可能的原因： 1. **解释器路径不一致** PyCharm 和终端使用的 Python 解释器版本不同，可能导致模块加载失败或依赖库缺失[^1]。 2. **工作目录设置问题** 终端的工作目录与 PyCharm 的默认工作目录可能存在差异，从而影响相对路径下的文件访问[^2]。 3. **PYTHONPATH 配置冲突** 在 PyCharm 中，`PYTHONPATH` 环境变量会被自动调整以包含项目的根目录和其他必要的子目录。然而，在终端环境中，如果未手动设置 `PYTHONPATH`，可能会导致导入自定义包时出现 `ModuleNotFoundError` 错误。 --- ### 解决方案 #### 方法一：确认并统一解释器路径 确保终端和 PyCharm 使用的是同一个 Python 解释器。可以通过以下方式验证： - 在 PyCharm 设置中查看当前项目所选的解释器位置（Settings → Project Interpreter）。 - 在终端输入以下命令检查解释器路径是否匹配： ```bash which python ``` 或者对于特定版本： ```bash which python3 ``` 如果不一致，则需修改终端中的解释器路径或将 PyCharm 切换到与终端相同的解释器上。 #### 方法二：调整工作目录 在终端运行脚本前，切换至正确的项目根目录。例如，假设项目位于 `/path/to/project/`，则应先通过以下命令进入该目录后再运行脚本： ```bash cd /path/to/project/ python script_name.py ``` 此操作可避免因路径问题引发的异常行为。 #### 方法三：正确配置 PYTHONPATH 当尝试从外部调用本地编写的模块时，需要将父级目录加入系统的 `PYTHONPATH` 环境变量中以便于定位资源。具体做法如下所示： ```bash export PYTHONPATH="${PYTHONPATH}:/absolute/path/to/your_project" ``` 注意替换上述语句里的占位符为实际绝对地址值；另外每次新开 shell session 均需重新声明除非将其写入 `.bashrc` 或者其他启动脚本里永久生效。 #### 方法四：重构代码结构 考虑优化程序架构设计来减少对复杂 import 结构的需求。比如采用显式的 package 安装形式而非简单放置同层文件夹下互相引用的方式处理逻辑关系更为清晰稳定长久有效。 --- ### 示例修正后的运行流程 假设有这样一个简单的例子涉及跨文件引用情况: main.py 文件内容: ```python from items import ItemClass def main(): item = ItemClass() print(item.get_info()) if __name__ == "__main__": main() ``` items.py 文件内容: ```python class ItemClass: def get_info(self): return "This is an example of importing custom modules." ``` 按照前述建议完成相应更改之后, 应能够在任何环境下顺利执行下面这条指令得到预期输出结果: ```bash python main.py ``` ---