Django使用startapp时顶层模块与子模块的区别及选择方法

首先引用Django官方教程的对应说明：

应用可放置在Python路径的任意位置，本教程将在manage.py同级目录创建投票应用，使其作为独立顶层模块被导入，而非mysite的子模块

两者核心差异 #

• 导入路径不同
  顶层模块存放在manage.py同级目录，导入时直接用import 应用名即可，比如教程里的import polls。如果是放在项目根包（比如教程中的mysite文件夹）下的子模块，导入时需要写完整路径import mysite.polls，层级更深。
• 可复用性不同
  顶层模块完全独立于当前项目，后续做其他项目需要用到同款功能时，直接把整个应用文件夹拷贝到新项目就能直接用，不需要修改内部的导入语句。子模块的所有内部导入都绑定了当前项目的根包名，迁移到其他项目时需要批量修改所有导入路径，很容易出BUG。
• 冲突风险不同
  顶层模块的命名不能和Python内置模块、已安装的第三方包重名，比如不能给应用取名叫requests，否则导入时会和第三方requests库冲突。子模块因为带有项目根包前缀，几乎不会出现命名冲突问题。
• 结构可读性不同
  小型项目用顶层模块时，所有应用都和manage.py放在同一层级，打开项目根目录就能直接看到所有功能模块，找文件很方便。子模块会和项目的settings.py、urls.py等核心配置文件混在同一个文件夹里，新手找文件会更费劲。

个人业余项目的选择建议 #

作为刚入门的新手，开发第一个个人项目时优先选择顶层模块形式，和官方教程的结构保持一致即可：

• 官方文档、社区教程的绝大多数示例都是用顶层模块结构，遇到问题搜解决方案时可以直接对应，不需要额外调整路径规则，踩坑概率更低。
• 个人业余项目一般体量都不大，顶层模块的结构足够清晰，完全可以满足需求。
• 只有当你明确某款应用完全是当前项目专属、不可能复用在其他项目，且你已经完全熟悉Python的导入规则时，再考虑使用子模块形式。

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