如何在IntelliJ中添加本地Python模块至类路径？Django运行配置报错求助

嘿，我之前在老版本IntelliJ里折腾Django项目时也碰到过一模一样的情况——终端能跑，IDE里就报错，核心问题几乎都是解释器版本不匹配导致的，咱们一步步来搞定：

1. 先锁定问题根源 #

你看报错里的执行命令是/usr/bin/python2.7 -d /Users/my_user/dev/github/my_project/manage.py runserver 8000，说明IntelliJ当前用的是系统默认的Python 2.7，但你的项目在终端里能正常运行，大概率终端用的是Python 3（或者你配置的虚拟环境解释器），版本不兼容就会出问题。

2. 修正Run Configuration的解释器 #

这是最常见的解决办法：

• 点击右上角运行按钮旁边的下拉菜单，选择「Edit Configurations...」
• 在弹出的窗口里，找到你的Django「runserver」配置项
• 看右侧的「Python interpreter」下拉框，确保选中的是你之前配置好的项目专属Python SDK（比如虚拟环境里的Python3，而不是系统的/usr/bin/python2.7）
• 确认后点击「Apply」再「OK」，重新启动试试

3. 核对IDE的PYTHONPATH和环境变量 #

有时候终端的环境变量和IDE的不一样：

• 先在系统终端里执行echo $PYTHONPATH，记下输出内容
• 回到IntelliJ的Run Configuration页面，找到「Environment variables」选项，点击右侧的编辑按钮
• 检查PYTHONPATH的值是不是和终端里的一致，如果不一样就改成终端里的路径
• 另外也可以去「File → Project Structure → SDKs」里，选中你的Python SDK，查看「Paths」标签下的内容，确保项目根目录和依赖包路径都正确添加了

4. 检查manage.py的shebang行 #

打开项目根目录的manage.py，看第一行的shebang声明：

#!/usr/bin/env python3

如果这里写的是python或者python2，IDE可能会优先用系统默认的解释器，改成你项目用的Python版本对应的声明，比如python3.8（根据你的实际版本来）

5. 用IDE内置终端验证 #

如果上面的步骤都试过还是不行，打开IntelliJ底部的「Terminal」，执行python manage.py runserver：

• 如果能正常启动，说明IDE的环境没问题，就是Run Configuration的解释器没选对
• 如果还是报错，那可能是IDE的环境变量没加载全，试试重启IntelliJ或者重新导入项目

你的报错信息：
/usr/bin/python2.7 -d /Users/my_user/dev/github/my_project/manage.py runserver 8000
Traceback (most recent call la...

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