django CMS快速上手:3条命令安装,5分钟看到第一个页面(新手完全教程)

原创2026-09-21 09:33:481,811 阅读
文章标签:CMS后端Web框架内容协同

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 件事:

  1. 用官方项目模板创建一个完整的 Django 项目
  2. 安装富文本、前端组件、文件管理、版本控制等配套包
  3. 执行数据库迁移(创建 SQLite 数据库)
  4. 提示你创建一个超级管理员账号
  5. 运行安装检查,确认一切就绪

命令背后的实现位于 cms/management/djangocms.py,各子命令(check、tree、uninstall 等)在 cms/management/commands/subcommands/。

然后启动开发服务器:

cd coffeesite
python -m manage runserver

浏览器打开 http://localhost:8000/,登录刚才创建的超级管理员,你会看到 django CMS 的欢迎页:

django CMS 安装成功后的欢迎页面,顶部有编辑工具栏

恭喜,django CMS 已经跑起来了!🎉

5分钟创建并发布第一个页面

接下来全部在页面上点鼠标完成,零代码。

第1步:用向导新建页面

django CMS 新建页面表单,填写页面标题后点击 Create

  1. 点击顶部工具栏的 Create,选择 New page
  2. 在 Title 中填入 Home,点击 Create

📌 小知识:你创建的第一个页面会自动成为网站首页,直接运行在 http://localhost:8000/。

第2步:给页面添加文本内容

  1. 点击页面右上角的开关,打开结构板(Structure Board)
  2. 在 Page Content 占位符旁点击 + 号,选择 Text 插件
  3. 在富文本编辑器里写一个标题和一段正文,点击 Save

django CMS 结构板中添加 Text 文本插件的界面

这就是 django CMS 的核心数据模型,后续你会反复见到这三个词:

页面(Page) → 占位符(Placeholder) → 插件(Plugin)

第3步:发布页面

此时页面只是草稿,访客看不到。点击工具栏右侧的 Publish,再用一个未登录的浏览器窗口访问 http://localhost:8000/,左边是编辑模式(带工具栏),右边是访客看到的干净页面:

django CMS 编辑模式与发布后页面效果的对比

照同样步骤再建一个 About 页面并发布,访问 http://localhost:8000/about/ 即可看到。跟着完整官方教程走,最终会得到一个带导航菜单的完整首页:

使用 django CMS 搭建的站点首页,包含导航菜单和内容卡片

新手常见问题(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 之旅吧!🚀

登录后查看全文
django-cms