Python Web 框架 django-vue3-admin前后端项目运行完整步骤

准备工作

Python >= 3.8.0 (推荐3.9.7)
nodejs >= 16 (推荐v16.20.1)
Mysql >= 5.7.0 (可选，默认数据库sqlite3，推荐8.0版本)
Redis(可选，最新版)

• 基于PyCharm工具开发(待更新)
• 基于VsCode工具开发(待更新)
• 基于Docker环境开发(待更新)

开发工具

前端

WebStorm

VsCode

后端

PyCharm

VsCode

正常的下载代码

通过 git clone https://gitee.com/huge-dream/django-vue3-admin.git 下载到工作目录

注意：你的开发环境请使用dev分支进行

其它下载代码的方法

可以先Fork仓库至你项目，然后再基于dev创建你自己的分支，比如创建一个基于官方dev的MyDev分支，接着你再下载拉取你的项目仓库代码至工作目录，最后切换至MyDev分支进行开发便可。

在这种情况下，如果我们dvadmin3更新了代码，你可以使用gitee仓库功能进行强制同步最新代码至你的仓库，后面再合并最新代码至你的MyDev分支便可。通过这种方法你可以始终保持与官方代码一致。

后端配置env.py文件

如下我是以宝塔面板为示例进行说明的，如果是windows环境或者其它，可作参考。

1. 进入后端项目目录:cd backend
2. 在项目根目录中，复制 ./conf/env.example.py 文件为一份新的到 ./conf/env.py 下，并重命名为env.py

注意这里必须要设置env.py的权限

如果不设置权限的话,等一下django项目会无法导入配置模块conf.env

修改完权限如下

建议有条件的情况下，还是使用mysql8.0数据库

mysql数据库的配置

mysql的配置根据自己创建mysql数据时的配置参数填写便可

import os

from application.settings import BASE_DIR

# ================================================= #
# *************** mysql数据库 配置  *************** #
# ================================================= #
# 数据库 ENGINE ，默认演示使用 sqlite3 数据库，正式环境建议使用 mysql 数据库
# sqlite3 设置
# DATABASE_ENGINE = "django.db.backends.sqlite3"
# DATABASE_NAME = os.path.join(BASE_DIR, "db.sqlite3")

# 使用mysql时，改为此配置
DATABASE_ENGINE = "django.db.backends.mysql"
DATABASE_NAME = 'dvadmin3' # mysql 时使用

# 数据库地址 改为自己数据库地址
DATABASE_HOST = "127.0.0.1"
# # 数据库端口
DATABASE_PORT = 3306
# # 数据库用户名
DATABASE_USER = "dvadmin3"
# # 数据库密码
DATABASE_PASSWORD = "t6NCtd6GJiRsCCGZ"

# 表前缀
TABLE_PREFIX = "dvadmin_"
# ================================================= #
# ******** redis配置，无redis 可不进行配置  ******** #
# ================================================= #
# REDIS_PASSWORD = ''
# REDIS_HOST = '127.0.0.1'
# REDIS_URL = f'redis://:{REDIS_PASSWORD or ""}@{REDIS_HOST}:6380'
# ================================================= #
# ****************** 功能 启停  ******************* #
# ================================================= #
DEBUG = True
# 启动登录详细概略获取(通过调用api获取ip详细地址。如果是内网，关闭即可)
ENABLE_LOGIN_ANALYSIS_LOG = True
# 登录接口 /api/token/ 是否需要验证码认证，用于测试，正式环境建议取消
LOGIN_NO_CAPTCHA_AUTH = True
# ================================================= #
# ****************** 其他 配置  ******************* #
# ================================================= #

ALLOWED_HOSTS = ["*"]

# daphne启动命令
#daphne application.asgi:application -b 0.0.0.0 -p 8000
sqlite3 数据库的配置及redis配置请参考上面代码中的注释部分

后端运行

以下每一步都很重要，请不要跳过

1. 进入后端项目目录:cd backend

2. 安装依赖环境: pip3 install -r requirements.txt

   如果在安装依赖的过程中，出现一些包有问题，可自行先把它取消掉，先完成大部分包的安装之后，再尝试启动项目，后面有时间的话，你再慢慢的进行调整包的依赖
   

3. 执行迁移命令: python3 manage.py makemigrations``python3 manage.py migrate

4. 初始化数据: python3 manage.py init

5. 初始化省市县数据: python3 manage.py init_area

6. 启动项目: python3 manage.py runserver 0.0.0.0:8000

前端配置env

• 开发环境配置``web/.env.development，主要是配置VITE_API_URL`地址为开发环境的后端地址

  开发环境必配置的地址VITE_API_URL，请配置至自己的开发环境的后端

  # 开发环境
  ENV = 'development'
  
  # 本地环境接口地址
  VITE_API_URL = 'http://127.0.0.1:8000/'
  
  # 是否启用按钮权限
  VITE_PM_ENABLED = true
  

• 生产环境配置web/.env.production，主要是配置``VITE_API_URL`地址为生产环境的后端地址

  如果你还不打算配置生产环境，你可以不必关心这里

  # 线上环境
  ENV = 'production'
  
  # 线上环境接口地址
  # VITE_API_URL = '/api' # docker-compose部署不需要修改，nginx容器自动代理了这个地址
  
  VITE_API_URL = 'http://192.168.202.17:8001/'
  
  
  # 是否启用按钮权限
  VITE_PM_ENABLED = true
  

前端运行

1. 进入前端项目目录 cd web

2. 安装依赖 npm install --registry=https://registry.npm.taobao.org

   #或直接运行
   npm install
   

3. 启动服务 npm run dev

访问项目

• 访问地址：http://localhost:8080 (如果你访问的话远程主机，请确保该主机8080端口防火墙已打开再访问http://地址:8080)
• 账号：superadmin 密码：admin123456

---

links：

Django-vue3-admin (django-vue-admin.com)