Django访问current_datetime遇TemplateDoesNotExist错误怎么办
模板不存在报错的排查与修复方案
问题根因
- 模板查找规则不匹配
当前settings.py的TEMPLATES配置中DIRS为空,仅开启APP_DIRS=True:该模式下Django仅会自动扫描所有已安装APP下名为templates的目录,不会遍历项目其他层级的自定义文件夹。
视图render()调用时传入的模板路径mysite/template/current_datetime.html存在两处硬伤:一是使用了单数命名的template目录,不符合Django约定的复数templates目录要求;二是路径层级不符合APP_DIRS的查找逻辑,会让Django去不存在的嵌套路径中找文件。 - 启动命令拼写错误
执行的python manage.py run server存在语法问题,Django内置的开发服务启动命令为连写的runserver,空格拆分的写法会直接触发命令不存在的报错。 - 模板变量引用不匹配
视图向模板传递的上下文键为datetime,但模板内写了带空格的{{date time}},不符合Django模板语法规则,即使模板正常加载也无法渲染时间值。
修复步骤
- 规范模板存储路径
- 公共目录方案:在与
manage.py同级的项目根目录下新建全小写templates文件夹,移入current_datetime.html;同时修改TEMPLATES配置,将DIRS项设置为[BASE_DIR / 'templates'],让Django主动扫描该公共目录。 - APP内置方案:确认视图所在APP已注册到
INSTALLED_APPS列表,在APP目录下新建带复数s的templates文件夹,按防重名规范在templates下新建APP名同名子目录,将模板移入该子目录。
- 公共目录方案:在与
- 修正render模板路径
- 公共目录方案下,直接传入模板文件名
current_datetime.html即可,无需拼接多余的上级路径前缀。 - APP内置方案下,传入相对
templates目录的路径(如mysite/current_datetime.html)即可,无需手动拼接绝对路径。
- 公共目录方案下,直接传入模板文件名
- 正确启动服务
- 执行连写命令
python manage.py runserver启动开发服务。
- 执行连写命令
- 修正模板变量
- 将模板中带空格的
{{date time}}替换为{{ datetime }},与视图传递的上下文键保持一致,确保时间值正常渲染。
- 将模板中带空格的
内容的提问来源于stack exchange,提问作者saeedzali
相关产品推荐
相关产品推荐

