由於工作需要，接觸了大半年時間的Django+xadmin框架，一直沒空對這塊對進行相關的梳理。最近在同事的慫恿下，就在這分享下筆者的學習及工作經驗吧。

好了，話不多說，下面開始進入正題：

環境需求：

筆者的工作系統環境：Mac 10.13.4+Python3.6.x+Django2.0.x+Xadmin2.0

因此本系列教程均是以此組合為基礎展開講解。其他系統版本也基本適用，有小部分不兼容之處請自行測試。

一、Django及xadmin安裝

可以使用pip命令進行安裝，或者直接下載安裝包用python命令安裝：

pip3 install Django

pip3 install git
 
+git://github.com/sshwsfc/xadmin.git@django2

由於xadmin2.0官方版本存在一些兼容性bug，筆者對其源碼進行了部分改動

在裝完官方版的Django和xadmin之後，將筆者的xadmin修復版本替換到xadmin的原安裝目錄下即可。

更詳細安裝過程不再贅述，要細說的話得花一整天時間。

二、使用Pycharm創建項目

1、打開pycharm，第一次創建項目，我們就選擇create new project

2、按圖上的順序配置好，Location及Application name可以根據自己需要自定義，項目解析器筆者此處選擇了系統環境路徑。全部設置好之後創建項目。

3、創建好的項目長得是這個樣子的

4、點右上角的綠色啟動箭頭，OK，我們的項目已經正常跑起來了。

同時，我們也可以在項目目錄下，執行命令來運行項目

python3 manage.py runserver 0.0.0.0:8000

萬裏長征邁出了勝利的第一步，接下來要來嫁接xadmin。

三、 改造Django項目，適配xadmin

1、首先，看看項目的結構

manage.py是網站的啟動文件，一般不需要改動。
demo文件夾是網站配置文件夾，我們需要操作的文件主要有：settings.py和urls.py
settings.py是網站的主要配置文件

urls.py是路由文件
app文件夾是創建項目時默認創建的模塊，主要的開發在這裏。

2、下面開始著手改造，先來修改url.py

# from django.contrib import admin
import xadmin
from django.urls import path
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # path(‘admin/‘, admin.site.urls),
    path(r‘‘, xadmin.site.urls),
]

3、接著是修改settings.py，將127.0.0.1加入白名單

ALLOWED_HOSTS = [‘127.0.0.1‘]

4、修改INSTALLED_APPS，加入xadmin相關組件

在最上面加入app.apps.AppConfig，接著添加xadmin及crispy_forms

INSTALLED_APPS = [
    ‘app.apps.AppConfig‘,
    ‘xadmin‘,
    ‘django.contrib.admin‘,
    ‘django.contrib.auth‘,
    ‘django.contrib.contenttypes‘,
    ‘django.contrib.sessions‘,
    ‘django.contrib.messages‘,
    ‘django.contrib.staticfiles‘,
    ‘crispy_forms‘,
]

5、這樣，我們便能夠讓xadmin項目跑起來了。試試看

點擊登錄，會發現報了一個錯

上面的提示是，沒有用戶表。原來，我們還沒有對數據庫進行初始化。

6、初始化數據庫

項目創建好時默認的是使用sqlite3數據庫，我們也可以指定它使用MySQL數據庫，修改 DATABASES

DATABASES = {
    ‘default‘: {
        # ‘ENGINE‘: ‘django.db.backends.sqlite3‘,
        # ‘NAME‘: os.path.join(BASE_DIR, ‘db.sqlite3‘),
        ‘ENGINE‘: ‘django.db.backends.mysql‘,  # 數據庫引擎
        ‘NAME‘: ‘demo‘,
        ‘USER‘: ‘root‘,
        ‘PASSWORD‘: ‘123456‘,
        ‘HOST‘: ‘127.0.0.1‘,
        ‘PORT‘: ‘3306‘,
        ‘OPTIONS‘: {
            ‘init_command‘: "SET sql_mode=‘STRICT_TRANS_TABLES‘;"  # 初始化數據庫的命令
        }
    }
}

運行數據庫遷移命令

python3 manage.py migrate

7、此外，我們還要建立一個超級管理員帳號，設置好帳號密碼郵箱信息

python3 manage.py createsuperuser

8、好了，萬事具備，下面可以順利的進入管理界面了

9、現在這個界面是英文的，看起來是不是有點不太習慣呢？下面我們就要讓它顯示中文。

在settings.py文件開頭添加一行代碼

from django.utils.translation import ugettext_lazy as _

修改 LANGUAGE_CODE 和 LANGUAGES

LANGUAGE_CODE = ‘zh-hans‘

LANGUAGES = [
    (‘en‘, _(‘English‘)),
    (‘zh-hans‘, _(‘Simplified Chinese‘)),
    (‘zh-hant‘, _(‘Traditional Chinese‘)),
]

10、重新運行一下，OK，我們熟悉的中文界面呈現在眼前。

好了，不早了，該下班回家了。 下一節，我們將創建模型。

【Python3.6+Django2.0+Xadmin2.0系列教程一】環境搭建及項目創建