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

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服务器。

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！