MarsMgn

外观

快速启动（后端） ​

准备开发环境 ​

介绍 ​

准备后端开发环境流程包括

  • 安装Python
  • 安装MYSQL
  • 安装Redis
  • 安装VSCode
  • 安装Git工具
  • 安装DBeaver
  • 安装Another Redis Desktop Manager

下面以Windows环境进行说明

安装Python ​

Python推荐3.11版本，下载地址

image-20250615080828097

安装MySQL ​

MySQL推荐8.0版本，下载地址

image-20250615081244087

image-20250615081304178

MySQL 安装教程

安装Redis ​

Redis 推荐6版本，但由于Windows上只有5版本，这里安装5版本。下载地址

image-20250615081831154

安装VSCode ​

VSCode下载地址

image-20250615082002261

VSCode安装插件

  • Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code
  • Python
  • Pylance
  • Black Formatter ：代码格式化工具
  • Lingma：通义灵码是由阿里云提供的智能编码辅助工具。（也可选择自己熟悉的AI辅助编码工具）

安装Git工具 ​

Git工具下载地址

image-20250615084553189

配置Git工具

  • 安装后首次使用 Git 时，需要配置用户信息，这些信息会记录在提交历史中。

  • 打开Git Bash，执行下面命令

    sh
    # 按实际填写name和email
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"
# 记住密码
git config --global credential.helper store
# 关闭路径转义，用于正确显示中文
git config --global core.quotepath false

# 查看全局配置
git config --global --list

安装DBeaver ​

DBeaver是一个开源的数据库管理工具，支持主流数据库系统（如 MySQL等），也可以使用Navicat。下载地址

image-20250615105514802

解压即可使用。

安装Another Redis Desktop Manager ​

Another Redis Desktop Manager是一个Redis的图形管理界面工具。下载地址

image-20250615113237085

解压即可使用。

配置与启动 ​

下载源码 ​

新建一个文件夹作为项目文件夹，例如my-django。进入该文件夹，右击选择“Open Git Bash Here”

image-20250615084954856

在Git Bash中，执行下面命令

sh
# 初始化python虚拟环境
python -m venv venv

# 下载源码
git clone https://gitee.com/zhulj993/mars-mgn.git

创建数据库 ​

创建数据库步骤

  • 打开DBeaver，点击菜单栏的“数据库——新建数据库连接”，数据库类型选择MySQL，下一步
  • 填写服务器地址、端口、用户名和密码。点击完成。

image-20250615112056033

  • 成功连接后，右击数据库，选择“新建数据库”。填写数据名等信息。
sh
数据库名称：mars-mgn
字符集：utf8mb4
排序规则：utf8mb4_general_ci

image-20250615112431562

image-20250615111235909

修改配置文件 ​

使用VSCode打开项目：进入my-django文件夹，右击选择“通过Code打开”

image-20250615114927470

打开Django项目配置文件：mysite\mysite\settings.py

  • 数据库配置：填写实际的地址、端口、用户名和密码。

image-20250615113953512

  • Redis配置：填写实际的地址、密码（可选）。

image-20250615113855391

安装依赖与初始化数据 ​

在VSCode中，点击查看——终端，打开终端。

  • 在VSCode中，点击打开任意一个Python文件，例如mysite\mysite\settings.py
  • 观察VSCode右下角，确认处于Python虚拟环境中

image-20250615153945885

  • 在终端中执行下面命令
sh
# 安装依赖
pip install -r requirements.txt

# 进入项目的根目录（即包含manage.py的目录），执行数据库迁移
cd mysite
python manage.py migrate

# 初始化数据库数据
python manage.py loaddata myapp_system.json myapp_infra.json
python manage.py loaddata django_celery_beat.json django_celery_results.json

启动项目 ​

打开VSCode终端，进入项目的根目录（即包含manage.py的目录），执行下面命令

sh
python manage.py runserver

### 输出下面信息
System check identified no issues (0 silenced).
June 15, 2025 - 15:42:23
Django version 4.2.20, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/  
Quit the server with CTRL-BREAK.

打开浏览器，输出后端IP地址和端口。例如：http://127.0.0.1:8000/api/schema/swagger-ui/

如果启动成功，能看到Swagger的API界面。

image-20250615165152998