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

以下是針對PyCharm IDE優(yōu)化的部署流程，整合多來源的最佳實踐：

一、環(huán)境準備

安裝Python 3.11+?

官方下載安裝包，勾選 ?Add Python to PATH?
驗證安裝：python --version（需顯示3.11+）

安裝Node.js 18.x LTS?

官網(wǎng)下載安裝包，驗證：node -v

安裝PyCharm Professional?

官網(wǎng)下載安裝包，勾選關(guān)鍵選項：
? Add "bin" folder to the PATH
? Associate .py files with PyCharm

可選組件?

MySQL 8.0+（字符集設(shè)為utf8mb4）
Redis（最新版）
二、項目配置

源碼獲取?

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

刪除 web/src/views/system/demo/demo.vue 并注釋相關(guān)CURD代碼

PyCharm后端配置?

打開backend目錄作為項目
創(chuàng)建虛擬環(huán)境：
bash
Copy Code
python -m venv venv
venv\Scripts\activate

安裝依賴：pip install -r requirements.txt（使用清華源）
復(fù)制 conf/env.example.py → conf/env.py，配置MySQL連接（字符集utf8mb4）

數(shù)據(jù)庫初始化?

bash
Copy Code
python manage.py makemigrations
python manage.py migrate
python manage.py init # 初始化權(quán)限數(shù)據(jù)
python manage.py init_area # 初始化省市縣數(shù)據(jù)

PyCharm前端配置?

新窗口打開web目錄
安裝依賴：npm install --registry=https://registry.npm.taobao.org
配置運行參數(shù)：
命令：run
Scripts：dev
端口修改：編輯.env.development文件
三、啟動服務(wù)

后端啟動?

在backend項目中：
右鍵manage.py → Run 'manage'
添加參數(shù)：runserver 0.0.0.0:8000
或終端執(zhí)行：python manage.py runserver

前端啟動?

在web項目中：
點擊運行按鈕（選擇npm配置）
或終端執(zhí)行：npm run dev
四、訪問驗證
訪問入口 默認憑證 說明
http://localhost:8080 superadmin/admin123456 前端系統(tǒng)
http://localhost:8000/admin 需createsuperuser創(chuàng)建 Django Admin后臺
五、常見問題解決

靜態(tài)文件加載失敗?

bash
Copy Code
python manage.py collectstatic

并在settings.py配置STATIC_ROOT

端口沖突?

后端：修改manage.py運行參數(shù)為runserver 端口號
前端：修改web/.env.development的VUE_APP_PORT

虛擬環(huán)境激活失敗?

PyCharm設(shè)置 → Tools → Terminal → 勾選Activate virtualenv

部署全程無需Apache/Nginx，開發(fā)環(huán)境直接用內(nèi)置服務(wù)即可。生產(chǎn)部署建議切換Waitress/Daphne服務(wù)器。