Django-vue3-admin Windows PyCharm本地部署指南

以下是针对PyCharm IDE优化的部署流程，整合多来源的最佳实践：

一、环境准备

安装Python 3.11+‌

官方下载安装包，勾选 ‌Add Python to PATH‌
验证安装：python –version（需显示3.11+）

安装Node.js 18.x LTS‌

官网下载安装包，验证：node -v

安装PyCharm Professional‌

官网下载安装包，勾选关键选项：
Add “bin” folder to the PATH
Associate .py files with PyCharm

可选组件‌

MySQL 8.0+（字符集设为utf8mb4）
Redis（最新版）
二、项目配置

源码获取‌

bash
Copy Code
git clone https://gitee.com/huge-dream/django-vue3-admin.git

删除 web/src/views/system/demo/demo.vue 并注释相关CURD代码

PyCharm后端配置‌

打开backend目录作为项目
创建虚拟环境：
bash
Copy Code
python -m venv venv
venv\Scripts\activate

安装依赖：pip install -r requirements.txt（使用清华源）
复制 conf/env.example.py → conf/env.py，配置MySQL连接（字符集utf8mb4）

数据库初始化‌

bash
Copy Code
python manage.py makemigrations
python manage.py migrate
python manage.py init # 初始化权限数据
python manage.py init_area # 初始化省市县数据

PyCharm前端配置‌

新窗口打开web目录
安装依赖：npm install –registry=https://registry.npm.taobao.org
配置运行参数：
命令：run
Scripts：dev
端口修改：编辑.env.development文件
三、启动服务

后端启动‌

在backend项目中：
右键manage.py → Run ‘manage’
添加参数：runserver 0.0.0.0:8000
或终端执行：python manage.py runserver

前端启动‌

在web项目中：
点击运行按钮（选择npm配置）
或终端执行：npm run dev
四、访问验证
访问入口 默认凭证 说明
http://localhost:8080 superadmin/admin123456 前端系统
http://localhost:8000/admin 需createsuperuser创建 Django Admin后台
五、常见问题解决

静态文件加载失败‌

bash
Copy Code
python manage.py collectstatic

并在settings.py配置STATIC_ROOT

端口冲突‌

后端：修改manage.py运行参数为runserver 端口号
前端：修改web/.env.development的VUE_APP_PORT

虚拟环境激活失败‌

PyCharm设置 → Tools → Terminal → 勾选Activate virtualenv

部署全程无需Apache/Nginx，开发环境直接用内置服务即可。生产部署建议切换Waitress/Daphne服务器。