---
url: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/updating'
title: '更新 DXPR Builder | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T13:51:51+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  更新 DXPR Builder 以获取错误修复、新功能和安全修复。
  您先用 Composer 更新代码，再让 Drupal 通过 drush updatedb 转换设置与内容。本页适用于 3.x
  系列内的更新。如果您还在使用 1.x 或 2.x，请改为参阅
  从 DXPR Builder 1.x 或 2.x 迁移。
  开始之前


  备份数据库：
tags:
  - 'Install and update'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T13:51:51+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: '更新 DXPR Builder'
      description: |-
        更新 DXPR Builder 以获取错误修复、新功能和安全修复。
        您先用 Composer 更新代码，再让 Drupal 通过 drush updatedb 转换设置与内容。本页适用于 3.x
        系列内的更新。如果您还在使用 1.x 或 2.x，请改为参阅
        从 DXPR Builder 1.x 或 2.x 迁移。
        开始之前


        备份数据库：
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T13:51:51+0000'
      dateModified: '2026-10-24T13:51:51+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/updating'
      articleSection: 安装与更新
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/updating'
      description: |-
        更新 DXPR Builder 以获取错误修复、新功能和安全修复。
        您先用 Composer 更新代码，再让 Drupal 通过 drush updatedb 转换设置与内容。本页适用于 3.x
        系列内的更新。如果您还在使用 1.x 或 2.x，请改为参阅
        从 DXPR Builder 1.x 或 2.x 迁移。
        开始之前


        备份数据库：
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: 首页
            item: 'https://dxpr.com/zh-hans'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: zh-hans
---
[帮助中心](/zh-hans/node/75)/[文档](/zh-hans/hc/documentation) /[学习 DXPR Builder](/zh-hans/hc/documentation/learn-dxpr-builder) /[从这里开始](/zh-hans/hc/documentation/learn-dxpr-builder/start-here) /[安装与更新](/zh-hans/hc/documentation/learn-dxpr-builder/start-here/install) # 更新 DXPR Builder.

 学习 DXPR Builder从这里开始安装与更新

   ## 本指南内容

 相关指南

- [备份和恢复构建器页面](/zh-hans/hc/documentation/learn-dxpr-builder/advanced/backup-restore)
- [更新日志](/zh-hans/hc/documentation/learn-dxpr-builder/getting-started/changelog)
- [更新后问题](/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating)

更新 DXPR Builder 以获取错误修复、新功能和安全修复。 您先用 Composer 更新代码，再让 Drupal 通过 `drush updatedb` 转换设置与内容。本页适用于 3.x 系列内的更新。如果您还在使用 1.x 或 2.x，请改为参阅 [从 DXPR Builder 1.x 或 2.x 迁移](/hc/documentation/learn-dxpr-builder/getting-started/migration-1x-to-3x)。

## 开始之前

- 备份数据库：

    ```bash
    drush sql:dump > backup-$(date +%Y%m%d).sql

    ```
- 阅读[更新日志](/hc/documentation/learn-dxpr-builder/getting-started/changelog)和 [GitHub 发布页面](https://github.com/dxpr/dxpr_builder/releases)，留意需要您处理的变更，例如迁移到 [Font Awesome 7](/hc/documentation/learn-dxpr-builder/getting-started/font-awesome-7)。
- 请先在站点的预发布副本上试运行更新。

## 更新模块

1. 更新代码：

    ```bash
    composer update drupal/dxpr_builder --with-dependencies

    ```
2. 运行数据库更新。您也可以改为访问 `/update.php`：

    ```bash
    drush updatedb

    ```

    某些更新会分批转换每一个 DXPR Builder 字段值。在大型站点上， 这需要几分钟，而不是几秒钟。
3. 重建缓存，以便浏览器获取新的样式表和脚本：

    ```bash
    drush cache:rebuild

    ```

## 您会看到的内容

包含 DXPR Builder 内容的页面外观与之前一致。以编辑人员身份将鼠标悬停在页面上， 即会显示控制栏；请做一处小改动并点击 **Save**，确认保存功能正常。**General Settings** 的 **License** 下仍会显示您的产品密钥。

然后打开 **Reports** > **Status report**（`/admin/reports/status`）。 在 **DXPR Builder content migrations** 旁边会显示 **All migrations completed**。

## 如果您没有看到新版本

- **编辑器的行为仍与旧版本一致。**浏览器保留了旧的编辑器文件。请用 Ctrl+Shift+R 重新加载，在 Mac 上则用 Cmd+Shift+R。
- **状态报告显示 "Some DXPR Builder content migrations have not been completed"。**仍有内容等待转换。请在该消息中打开 **View migration status**，或前往 `/admin/dxpr_studio/dxpr_builder/migration-status`，然后点击 **Run all pending migrations**。
- **页面显示异常或缺少元素。**请参阅[更新后出现的问题](/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating)，了解原因与解决方法。

如果更新破坏了站点，且上述方法都无效，请回滚：

1. 恢复数据库备份：

    ```bash
    drush sql:cli < backup-20260901.sql

    ```
2. 恢复您之前的版本，例如 3.0.0-beta19：

    ```bash
    composer require 'drupal/dxpr_builder:3.0.0-beta19'

    ```
3. 重建缓存：

    ```bash
    drush cache:rebuild

    ```

## 接下来做什么？

- [备份与恢复](/zh-hans/hc/documentation/learn-dxpr-builder/advanced/backup-restore)：在重大更新前为构建器内容建立备份流程。
- [更新日志](/hc/documentation/learn-dxpr-builder/getting-started/changelog)：每个版本的变化。
- [更新后出现的问题](/zh-hans/hc/documentation/learn-dxpr-builder/troubleshooting/after-updating)：最常见更新问题的解决方法。