django CMS快速上手:3条命令安装,5分钟看到第一个页面(新手完全教程)
django CMS快速上手:3条命令安装,5分钟看到第一个页面(新手完全教程)
django CMS 是一款基于 Django 的企业级开源内容管理系统(CMS)。本文是面向新手的 django CMS 安装教程:只需 3 条命令 完成安装,5 分钟 内就能看到你的第一个页面,无需数据库服务器、无需前端构建工具。
为什么选择 django CMS?
django CMS 主打“好用 + 开发者友好”,核心亮点包括:
- 🖥️ 前端编辑:编辑者直接在渲染好的页面上修改内容,所见即所得
- 🧩 占位符 + 插件系统:内容像搭积木一样自由组合
- 🌍 多语言与多站点:国际化开箱即用
- 🌳 层级页面树:自动生成 SEO 友好的 URL
- 🔄 版本与发布流程:草稿 / 已发布分离,编辑更安全
功能特性详见项目首页 README.rst。
安装前准备:3个前提条件
开始 django CMS 安装前,请确认:
| 前提条件 | 要求 |
|---|---|
| Python | ≥ 3.10(版本要求见 pyproject.toml) |
| pip | 能在终端正常使用 |
| Django 基础 | 了解 settings.py、manage.py、模板即可 |
不需要:现成的数据库服务器(教程默认使用 SQLite)、Node.js 或任何前端工具链。
💡 官方建议在虚拟环境中操作,保持环境干净。
3条命令完成 django CMS 安装
打开终端,依次执行:
python3 -m venv .venv
source .venv/bin/activate # Windows 用户:.venv\Scripts\activate
pip install django-cms
djangocms coffeesite
其中 djangocms 是本项目的“一键项目生成器”,它会自动帮你完成 5 件事:
- 用官方项目模板创建一个完整的 Django 项目
- 安装富文本、前端组件、文件管理、版本控制等配套包
- 执行数据库迁移(创建 SQLite 数据库)
- 提示你创建一个超级管理员账号
- 运行安装检查,确认一切就绪
命令背后的实现位于 cms/management/djangocms.py,各子命令(check、tree、uninstall 等)在 cms/management/commands/subcommands/。
然后启动开发服务器:
cd coffeesite
python -m manage runserver
浏览器打开 http://localhost:8000/,登录刚才创建的超级管理员,你会看到 django CMS 的欢迎页:
恭喜,django CMS 已经跑起来了!🎉
5分钟创建并发布第一个页面
接下来全部在页面上点鼠标完成,零代码。
第1步:用向导新建页面
- 点击顶部工具栏的 Create,选择 New page
- 在 Title 中填入
Home,点击 Create
📌 小知识:你创建的第一个页面会自动成为网站首页,直接运行在
http://localhost:8000/。
第2步:给页面添加文本内容
- 点击页面右上角的开关,打开结构板(Structure Board)
- 在
Page Content占位符旁点击 + 号,选择 Text 插件 - 在富文本编辑器里写一个标题和一段正文,点击 Save
这就是 django CMS 的核心数据模型,后续你会反复见到这三个词:
页面(Page) → 占位符(Placeholder) → 插件(Plugin)
第3步:发布页面
此时页面只是草稿,访客看不到。点击工具栏右侧的 Publish,再用一个未登录的浏览器窗口访问 http://localhost:8000/,左边是编辑模式(带工具栏),右边是访客看到的干净页面:
照同样步骤再建一个 About 页面并发布,访问 http://localhost:8000/about/ 即可看到。跟着完整官方教程走,最终会得到一个带导航菜单的完整首页:
新手常见问题(FAQ)
- 为什么匿名访问被重定向到登录页? 说明页面还没发布。登录后台 → Pages → 确认页面状态为 Published。
- 为什么 /about/ 提示 404? 未发布的页面在非首页 URL 上会直接返回 404,发布即可解决。
- 已有 Django 项目想接入 django CMS?
在项目根目录运行
djangocms .即可,参见 docs/how_to/24-add-to-existing-project.rst。
下一步学习路线
| 主题 | 文档路径 |
|---|---|
| 完整安装教程(本章节详解) | docs/tutorials/00-installing-django-cms.rst |
| 创建第一个页面 | docs/tutorials/01-first-page.rst |
| 手工安装(看清每一行配置) | docs/how_to/23-manual-installation.rst |
| 教程总览(咖啡馆建站实战) | docs/tutorials/index.rst |
3 条命令安装、5 分钟出页面——django CMS 的上手成本就是这么低。从占位符到插件,从多语言到版本管理,官方教程会带你一步步搭出完整的站点,开始你的 django CMS 之旅吧!🚀




