在本教程中，我们将学习如何将基于Django的项目打包成一个可执行的exe文件，以便在没有Python环境的计算机上运行。我们将通过使用 `PyInstaller` 工具实现这个目标。以下是你需要了解的原理和一些详细步骤。
#### 原理
PyInstaller 是一个用于将Python程序打包成独立的可执行文件的工具。它支持打包多种文件类型，包括exe, app和启动脚本等。PyInstaller 收集应用程序的所有依赖项（例如Python解释器、库、数据文件等），并将它们打包到一个单一的可执行文件中，以便在没有Python运行环境的计算机上运行。
#### 步骤
1. 安装PyInstaller：在你的虚拟环境（建议使用）或全局环境中，使用以下命令安装 PyInstaller：
```
pip install pyinstaller
```
2. 准备Django项目：在打包之前，确保你的Django项目已经被正确设置好并可以在电脑上运行。修改Django项目的 `settings.py` 文件，将 `ALLOWED_HOSTS` 设置为 ['*'] ，以便允许外部访问。
3. 创建一个入口文件：在Django项目的根目录下创建一个名为 `run.py` 的文件，此文件将作为项目的入口点。将以下代码添加到 `run.py` 中：
```python
import os
import sys
from django.core.management import execute_from_command_line
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'your_project_name.settings')
def main():
execute_from_command_line(sys.argv)
if __name__ == '__main__':
main()
```
其中，`your_project_name.settings` 需要替换为实际项目的设置文件路径。
4. 修改PyInstaller的隐藏导入配置：打开一个文本编辑器，在工作目录下创建一个名为 `hook-django.py` 的文件。将以下代码添加到 `hook-django.py` 文件中：
```python
from PyInstaller.utils.hooks import collect_submodules
hiddenimports = collect_submodules('django')
```
5. 使用PyInstaller打包Django项目：在命令行窗口或终端中，在Django项目的根目录下运行以下命令（以实际项目名称替换 `your_project_name` ）：
```bash
pyinstaller --additional-hooks-dir=. --name=your_project_name --onedir --hidden-import=django run.py
```
在此命令中，`--additional-hooks-dir` 指定PyInstaller查找自定义钩子文件的目录，`--name` 为生成的可执行文件指定名称，`--onedir` 参数指示将项目打包为一个单一的可执行文件，而 `--hidden-import=django` 参数告诉PyInstaller通过自定义钩子文件收集Django的所有依赖项。
6. 运行打包后的可执行文件：执行上述操作后，会在dist文件夹中生成`your_project_name`文件夹，进入该文件夹，可以找到一个名为 your_project_name.exe（或 your_project_name.app 在macOS上）的文件。双击运行它，或者在命令行或终端中执行以下命令来运行服务器：
```
your_project_name.exe runserver
```
现在你已成功将你的Django项目打包为一个可执行的exe文件！任何人无需安装Python或者Django环境，都可以在运行这个可执行文件，从而访问你的Django项目。
