最近開始學習Django，開發環境為Win10 + Python3.7 + Django2.1 + MySQL。本篇文章記錄在配置過程中碰到的各種問題以及解決方法。

一. 安裝開發環境

1. 安裝Python

2. 安裝Django

pip install Django

3. 安裝MySQL

二. 安裝依賴項

Django連線MySQL需要依賴以下庫：pymysql, mysqlclient。安裝方法如下：

pip install pymysql
pip install mysqlclient （如果執行失敗就參考後面的解決方法）

注意： 在安裝mysqlclient時有可能會報以下錯誤：

1. 需要Microsoft Visual C++ 14.0編譯環境。解決方法為安裝Microsoft Visual Studio 15.0。
2. 提示找不到"mysql.h"標頭檔案。目前還未深入研究如何破解此問題。

提示： 解決安裝mysqlclient失敗最簡單的方法如下：

1. 訪問網站 https://www.lfd.uci.edu/~gohlke/pythonlibs/ 下載與對應Python版本匹配的mysqlclient的windows二進位制安裝包（比如 mysqlclient‑1.3.13‑cp37‑cp37m‑win32.whl）
2. 執行以下命令安裝此二進位制包

pip install mysqlclient‑1.3.13‑cp37‑cp37m‑win32.whl
 

測試開發環境

1. 建立Django專案

django-admin startproject helloworld

2. 修改資料庫配置

修改專案資料夾下settings.py檔案中的資料庫的配置檔案，如下：

DATABASES = \
{
    'default':
    {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'leon',			#資料庫的名字
        'USER': 'root',			#登入資料庫的使用者名稱
        'PASSWORD': 'password',	#登入資料庫的密碼
 

        'HOST': 'localhost',	#資料庫的IP地址
        'PORT': '3306',			#資料庫的埠
    }
}

3. 重要步驟：將pymysql轉換為MySQLdb

修改專案資料夾下的__init__.py檔案，在其中加入以下程式碼：

import pymysql
pymysql.install_as_MySQLdb()

4. 同步資料庫

manage.py makemigrations
manage.py migrate

三. 常見問題

1. 執行manage migrate時報告“是否安裝了mysqlclient”的錯誤 參考上述的內容安裝mysqlclient

2. 執行manage migrate時報連線MySQL失敗的錯誤 a. 檢查資料庫是否正常執行 b. 檢查地址，埠，登入資訊，資料庫名等資訊是否正確 c. 檢查是否將pymysql轉換為MySQLdb d. 可執行以下程式碼檢查Python連線MySQL資料庫是否正常

import pymysql
db = pymysql.connect("localhost", "root", "password", "leon" )
cursor = db.cursor()
cursor.execute("SELECT VERSION()")
data = cursor.fetchone()
print ("Database version : %s " % data)
db.close()

3. 其他問題