Windows环境下Django项目一键启动部署及PyInstaller可行性咨询

可以用PyInstaller实现，但你的依赖里包含dlib、face-recognition这类带C扩展的库，需要做些额外配置，不是完全一键操作，下面是具体步骤：

1. 前置准备 #

• 确保本地Django项目能正常运行，所有依赖都装在虚拟环境里（避免全局依赖冲突）
• 安装PyInstaller：pip install pyinstaller

2. 调整Django项目配置 #

• 修改settings.py：
  • 把DEBUG设为False（打包后调试模式会导致异常）
  • 配置ALLOWED_HOSTS = ['localhost', '127.0.0.1']
  • 处理静态文件：先执行python manage.py collectstatic把静态文件统一收集到staticfiles目录，然后在settings.py里设置STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')，STATIC_URL = '/static/'
• 写一个自定义启动脚本（比如runserver.py），代替直接用manage.py：

import os
import sys
from django.core.management import execute_from_command_line

def main():
    os.environ.setdefault('DJANGO_SETTINGS_MODULE', '你的项目名.settings')
    try:
        # 固定启动地址和端口，避免用户输入
        execute_from_command_line([sys.argv[0], 'runserver', '127.0.0.1:8000'])
    except Exception as e:
        print(f"启动失败: {e}")
        input("按任意键退出...")

if __name__ == '__main__':
    main()

3. 处理特殊依赖 #

你的几个依赖PyInstaller无法自动识别全部文件，需要手动指定：

• dlib & face-recognition：找到虚拟环境中这两个库的安装目录（比如venv/Lib/site-packages/dlib），打包时要把整个目录包含进去
• OpenCV：确保把cv2所在的目录也包含进去，避免摄像头功能失效

4. 生成并编辑PyInstaller配置文件 #

先运行pyi-makespec runserver.py生成runserver.spec，然后编辑这个文件：

• 在datas列表里添加需要打包的资源和依赖目录：

datas=[
    ('你的项目名/templates', '你的项目名/templates'),
    ('staticfiles', 'staticfiles'),
    ('venv/Lib/site-packages/dlib', 'dlib'),
    ('venv/Lib/site-packages/face_recognition', 'face_recognition'),
    ('venv/Lib/site-packages/cv2', 'cv2'),
    # 其他静态资源或模板目录也要加在这里
]

• 在hiddenimports里补全PyInstaller可能遗漏的模块：

hiddenimports=[
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'django_object_actions',
    'django_user_agents',
    'django_cleanup',
    'imutils',
    'face_recognition',
    'dlib',
]

5. 执行打包 #

运行pyinstaller --onefile runserver.spec，--onefile会生成单个exe文件（嫌启动慢的话，换成--onedir生成目录，启动速度更快）。

6. 测试打包后的程序 #

• 找到dist文件夹里的runserver.exe，双击运行
• 会弹出命令行窗口（想隐藏的话，在spec文件里设置console=False），等服务启动后，打开浏览器访问http://127.0.0.1:8000
• 测试摄像头功能，要是打不开，检查OpenCV的库有没有打包全，或者Windows是否授权了摄像头访问

常见问题解决 #

• 提示找不到模块：检查hiddenimports有没有加对应模块，或者datas有没有包含依赖目录
• 静态文件加载失败：确认collectstatic执行过，且staticfiles目录被正确加入datas
• 摄像头无法调用：检查OpenCV的动态库是否打包完整，或者系统摄像头权限是否开启

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