Django Vite 项目常见问题解决方案

项目基础介绍

Django Vite 是一个开源项目，旨在将 ViteJS 集成到 Django 项目中。ViteJS 是一个现代化的前端构建工具，它利用原生 ES 模块提供快速的开发体验。该项目主要使用 Python 作为后端编程语言，并结合 JavaScript 和 HTML 等前端技术。

新手常见问题及解决步骤

问题一：如何安装 Django Vite？

解决步骤：

1. 首先，确保你的环境中已经安装了 Django。
2. 使用 pip 命令安装 django-vite：

   pip install django-vite
   

3. 将 django_vite 添加到你的 Django 项目的 INSTALLED_APPS 中，通常放在使用它的应用之前：

   INSTALLED_APPS = [
       'django_vite',
       # 其他应用...
   ]
   

问题二：如何在 Django 项目中配置 Vite？

解决步骤：

1. 按照 ViteJS 的官方文档，配置你的 ViteJS 项目。
2. 在 ViteJS 的配置文件中，设置 base 选项与你的 Django 项目的 STATIC_URL 保持一致。
3. 设置 build.outDir 路径到你希望编译资产存放的位置。
4. 确保 build.manifest 选项设置为 manifest.json。
5. 如果你是 SSR 模式而不是 SPA，需要直接在 build.rollupOptions.input 中指定要编译的文件路径。
6. 确保将 build.outDir 的路径添加到 Django 的 STATICFILES_DIRS 中。

问题三：如何在开发模式和生产模式下切换？

解决步骤：

1. 在 Django 的设置文件中定义 DJANGO_VITE 配置，例如：

   DJANGO_VITE = {
       "default": {
           "dev_mode": True
       }
   }
   

   或者使用传统的模块级设置：

   DJANGO_VITE_DEV_MODE = True
   

2. dev_mode 或 DJANGO_VITE_DEV_MODE 的布尔值决定了是否以开发模式包含资产。在开发模式下，资产作为模块使用 ViteJS 的 webserver 加载，这会启用热模块替换（HMR）。在生产模式下，资产作为标准资产加载，不使用 ViteJS。

通过上述步骤，新手用户可以顺利地开始使用 Django Vite 项目，并在开发过程中解决一些常见问题。