Django加载markdown_extras模板标签报错：找不到markdown模块求助

排查步骤及解决方案 #

• 确认markdown安装在项目对应的Python环境
  多数情况是全局安装了markdown，但项目使用的虚拟环境未安装。先查询项目使用的Python路径：

  • Linux/macOS终端运行：which python
  • Windows终端运行：where python
    拿到路径后，用该路径的pip重新安装：[你的Python路径] -m pip install markdown，例如/home/user/venv/bin/python -m pip install markdown。

• 检查templatetags目录结构合法性
  确保projects app的目录结构符合Django要求：

  projects/
      __init__.py
      templatetags/
          __init__.py
          markdown_extras.py
  

  必须保证templatetags文件夹下有__init__.py（空文件即可），同时projects要在settings.py的INSTALLED_APPS列表中注册。

• 重启Django开发服务器
  修改依赖或模板标签文件后，Django开发服务器不会自动重载依赖，手动关闭后重新启动python manage.py runserver，确保新安装的markdown库被加载。

• 验证markdown的可导入性
  进入项目的Python shell：python manage.py shell，输入import markdown。如果无报错，说明库能正常导入；如果仍报错，重复第一步的环境安装验证。

• 核对模板中的标签加载语法
  确保模板里加载标签的语句是{% load markdown_extras %}，拼写无错误，且模板所在的app已正确配置。

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