Django views.py导入同应用下自定义子目录模块失败问题咨询

导入失效的原因 #

Spyder运行报错的原因 #

相对导入的语法依赖当前文件作为包的子模块存在，当你直接在Spyder中单独运行views.py时，该文件会被Python识别为__main__顶级模块，而非django_app.views子模块，Python无法基于顶级模块定位同级的bot_funcs包，因此抛出你看到的报错。这个报错确实和Django运行环境无关，只是本地单文件运行的环境差异导致的。

Django站点500的原因 #

你写的from .bot_funcs import bot本身是符合Django应用导入规范的，触发500大概率不是导入语法的问题，优先排查以下情况：

• 检查django_app是否已经正确注册到项目settings.py的INSTALLED_APPS列表中
• 检查bot_funcs/bot.py内部是否存在语法错误、依赖缺失、内部导入错误，子模块自身的运行错误会向上传递，表现为上层导入失败
• 确认项目目录权限正常，Python进程有bot.py的读取权限

最优导入方式 #

Django应用内的子模块导入推荐两种合规写法，按优先级排序：

1. 绝对导入（更推荐，无歧义，适合大项目）

from django_app.bot_funcs import bot

这种写法直接基于项目顶层包名定位模块，不受相对路径层级变化影响，可读性和可维护性更高，是PEP8推荐的导入方式。
2. 相对导入（适合小项目，同层级内快速导入）
就是你原本的写法：

from .bot_funcs import bot

这种写法适合同个应用内的模块导入，不需要写完整包名，改动应用包名时不需要批量修改导入语句。

如果需要在Spyder等本地环境调试单文件代码，不要直接运行views.py，优先用Django shell调试：执行python manage.py shell进入Django运行环境后再导入对应模块，环境和线上完全一致，不会出现路径错误。如果一定要直接运行单文件，可以在文件开头临时添加路径：

import sys
import os
# 把django_app所在的项目根目录加到Python搜索路径
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
# 之后用绝对导入即可
from django_app.bot_funcs import bot

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