PyInstaller打包Django项目后无法找到HTML模板文件求助

方法1：通过spec文件手动添加模板资源 #

• 生成spec配置文件：pyi-makespec --name=crm manage.py
• 打开生成的crm.spec，找到datas列表，添加模板文件的映射关系（格式为(源路径, 目标路径)）：

  datas=[
      ('account/templates/account', 'account/templates/account'),
      # 如有其他app的模板，按同样格式添加
  ]
  

• 基于spec文件重新打包：pyinstaller crm.spec

方法2：调整Django模板配置适配打包环境 #

• 在项目的settings.py中，通过sys._MEIPASS获取PyInstaller打包后的临时运行目录，修正模板查找路径：

  import sys
  import os
  
  # 基础目录适配打包环境
  BASE_DIR = os.path.dirname(os.path.abspath(__file__))
  if hasattr(sys, '_MEIPASS'):
      BASE_DIR = sys._MEIPASS
  
  TEMPLATES = [
      {
          'BACKEND': 'django.template.backends.django.DjangoTemplates',
          'DIRS': [os.path.join(BASE_DIR, 'templates')],
          'APP_DIRS': True,
          # 其他配置保持不变
      },
  ]
  

• 确保APP_DIRS设为True，同时配合方法1的spec文件添加模板资源，保证打包后模板文件位置与配置路径匹配。

方法3：打包命令直接指定模板资源 #

• 在打包时使用--add-data参数直接嵌入模板文件，Windows系统用分号分隔路径，类Unix系统用冒号：

  # Windows环境
  pyinstaller --name=crm --add-data "account/templates/account;account/templates/account" manage.py
  
  # Linux/macOS环境
  pyinstaller --name=crm --add-data "account/templates/account:account/templates/account" manage.py
  

• 多app模板需多次添加--add-data参数，确保所有模板文件被打包。

方法4：验证打包后的文件结构 #

• 在settings.py或视图文件中添加调试代码，打印运行时的模板路径，确认文件是否存在：

  import sys
  import os
  
  if hasattr(sys, '_MEIPASS'):
      template_path = os.path.join(sys._MEIPASS, 'account/templates/account')
      print(f"模板目录路径: {template_path}")
      print(f"目录文件列表: {os.listdir(template_path)}")
  

• 运行crm.exe后查看控制台输出，确认dashboard.html是否在列表中，排查路径匹配问题。

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