在Django 5.0安装django-jalali-date时遇InvalidTemplateLibrary错误

问题原因 #

Python 3.12及以上版本不再默认内置distutils模块，而django-jalali-date的模板标签依赖该模块，导致加载jalali_date.templatetags.jalali_tags时触发ImportError。

解决方案 #

• 安装distutils依赖：
  • Debian/Ubuntu类系统：执行sudo apt-get install python3-distutils
  • CentOS/RHEL类系统：执行sudo dnf install python3-distutils
  • Windows/macOS（通过pip）：执行pip install setuptools（setuptools包中包含distutils模块）
• 验证安装：运行python -c "import distutils"，无报错则说明安装成功
• 重启Django服务：确保服务重启后，再测试模板中使用jalali日期标签的功能

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