PyCharm外部无法运行Python3脚本的原因及解决方法

问题根源 #

这事儿本质上是Python模块搜索路径（sys.path）的差异导致的：

• PyCharm会贴心地自动把你的项目根目录（也就是simple_top）加入到sys.path里，不管你怎么运行代码，它都能找到项目里的模块。
• 但终端直接运行脚本时，Python默认只加两个路径：当前工作目录（你敲命令时所在的文件夹）和Python自带的标准库路径。如果你的导入依赖的模块不在这两个路径里，或者你用了相对导入（比如from .a import xxx），就会报错——因为直接运行的脚本会被Python当作「顶级脚本」，不属于任何包，相对导入自然失效。

举个常见场景：如果你的b.py用了from .a import my_func这种相对导入，PyCharm会把整个simple_top当作一个包处理，所以能识别这个相对路径；但终端直接跑python b.py时，Python根本不认为这是包的一部分，直接就报错了。

解决方法（按推荐程度排序） #

1. 用-m参数以模块方式运行（最规范）

先给simple_top目录加个空的__init__.py文件，把它变成一个Python包，然后在终端里跑到simple_top的父目录，执行：

python -m simple_top.b

这种方式会让Python把simple_top当作包来加载，既支持相对导入，也能自动识别项目内的模块，和PyCharm的运行逻辑一致。

2. 把项目根目录加入PYTHONPATH环境变量

这是一劳永逸的办法，让Python永远能找到你的项目模块：

• 临时生效（仅当前终端窗口）：

  # Linux/macOS
  export PYTHONPATH="/你的/simple_top绝对路径:$PYTHONPATH"
  # Windows CMD
  set PYTHONPATH=C:\你的\simple_top绝对路径;%PYTHONPATH%
  # Windows PowerShell
  $env:PYTHONPATH = "C:\你的\simple_top绝对路径;$env:PYTHONPATH"
  

  设置完之后，不管你在哪个目录跑python b.py，都能正常导入a.py里的函数。
• 永久生效：
  Linux/macOS可以把上面的export命令加到~/.bashrc或~/.zshrc里；Windows可以在「系统环境变量」里新增PYTHONPATH，值填你的simple_top路径。

3. 在b.py里手动添加项目路径（临时救急）

如果只是临时测试，可以在b.py的最开头加几行代码，把项目根目录强行加入sys.path：

import sys
import os
# 获取b.py所在的目录（也就是simple_top）
project_root = os.path.dirname(os.path.abspath(__file__))
# 把项目根目录加到搜索路径里
sys.path.append(project_root)

# 现在就能正常导入了
from a import my_func

这种方法适合快速调试，但不推荐长期用——毕竟硬编码路径不够灵活。

4. 改用绝对导入并在项目根目录运行脚本

如果你的项目结构是simple_top下直接放a.py和b.py，那把b.py里的导入改成绝对导入（比如from a import my_func），然后在终端里先切换到simple_top目录，再运行：

cd /path/to/simple_top
python b.py

这种方式简单直接，但每次运行都得切到对应目录，有点麻烦。

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