---
url: 'https://dxpr.com/zh-hans/hc/documentation/learn-drupal/drupal-glossary/updating-drupal-core-composer'
title: '使用 Composer 更新 Drupal 核心 | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2026-10-24T08:17:28+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: '本文假设您使用 Composer 项目安装了 Drupal，例如drupal/core-recommended 或 drupal/dxpr-marketing-cms-project'
tags:
  - Drupal-woordenlijst
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T08:17:28+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: '使用 Composer 更新 Drupal 核心'
      description: '本文假设您使用 Composer 项目安装了 Drupal，例如drupal/core-recommended 或 drupal/dxpr-marketing-cms-project'
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2026-10-24T08:17:28+0000'
      dateModified: '2026-10-24T08:17:28+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-drupal/drupal-glossary/updating-drupal-core-composer'
      articleSection: Drupal-woordenlijst
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/zh-hans/hc/documentation/learn-drupal/drupal-glossary/updating-drupal-core-composer'
      description: '本文假设您使用 Composer 项目安装了 Drupal，例如drupal/core-recommended 或 drupal/dxpr-marketing-cms-project'
      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
---
[Help Center](/zh-hans/node/75)/[Documentation](/zh-hans/hc/documentation) /[Learn Drupal](/hc/documentation/learn-drupal) /[Drupal-woordenlijst](/hc/documentation/learn-drupal/drupal-woordenlijst) # 使用 Composer 更新 Drupal 核心.

 Learn DrupalDrupal-woordenlijst

   ## In this guide

本文假设您使用 Composer 项目安装了 Drupal，例如`drupal<span class="token operator">/</span>core<span class="token operator">-</span>recommended` 或 `drupal<span class="token operator">/</span>dxpr-marketing-cms-project`

## 列出可用的 Drupal 更新

```php
composer outdated "drupal/*"
```

如果没有以`drupal<span class="token operator">/</span>core`开头的行，说明 Composer 没有发现任何更新。如果有更新，请继续执行下面的命令

## 备份您的 Drupal 实例

更新生产网站时，请务必在更新前创建备份，即使您已在开发或测试环境中成功试过更新。请使用托管服务商的工具为 Drupal 网站创建备份或快照。

## 更新 Drupal 核心代码

**如果您使用的是** `drupal<span class="token operator">/</span>core<span class="token operator">-</span>recommended`：

```php
composer update "drupal/core-*" --with-all-dependencies
```

要模拟更新并查看会发生什么，而不实际更改任何内容，请添加`<span class="token operator">--</span>dry<span class="token operator">-</span>run`。

### 更新到核心的最新补丁版本

如果您希望将网站更新到最新的补丁版本，而不是最新的次版本，请添加`<span class="token operator">--</span>with<span class="token operator">=</span>`选项，为`drupal<span class="token operator">/</span>core<span class="token operator">-*</span>`依赖逐一指定，相关依赖列在`composer<span class="token punctuation">.</span>json`。

例如，如果 10.2 是当前次版本，而您希望将网站更新到 10.3 的最新补丁版本：

`composer update <span class="token string">"drupal/core-*"</span> <span class="token operator">--</span>with<span class="token operator">-</span>all<span class="token operator">-</span>dependencies <span class="token operator">--</span>with<span class="token operator">=</span>drupal<span class="token operator">/</span>core<span class="token operator">-</span>recommended<span class="token punctuation">:</span><span class="token operator">~</span><span class="token number">10.3</span><span class="token punctuation">.</span><span class="token number">0</span> <span class="token operator">--</span>with<span class="token operator">=</span>drupal<span class="token operator">/</span>core<span class="token operator">-</span>composer<span class="token operator">-</span>scaffold<span class="token punctuation">:</span><span class="token operator">~</span><span class="token number">10.3</span><span class="token punctuation">.</span><span class="token number">0</span>`

本例假设 `drupal<span class="token operator">/</span>core<span class="token operator">-</span>recommended` 和 `drupal<span class="token operator">/</span>core<span class="token operator">-</span>composer<span class="token operator">-</span>scaffold `是`composer<span class="token punctuation">.</span>json`中仅有的 Drupal 核心依赖。

### 更新到指定的核心版本

一般情况下，我们建议您在更新时不要指定具体的 Drupal 核心版本，除非您确定要锁定到某个特定版本。如果您确实希望将网站锁定到特定版本，可以参考以下示例：

要将网站锁定到 10.3.6 版本并相应更新所有依赖：

```php
composer require drupal/core-recommended:10.3.6 drupal/core-composer-scaffold:10.3.6 drupal/core-project-message:10.3.6 --update-with-all-dependencies
```

**警告**：如果您将网站锁定到某个特定的核心版本，该版本将被写入锁定文件，未来的更新不会超过该版本。要回到未锁定的核心版本，请按下方说明重新运行 require 命令。

### 取消锁定特定的核心版本

如果您正在运行锁定版本的 Drupal 核心，并希望将网站更新到另一个版本，您有两个选择。

1. 您可以运行上面的 composer require 命令，指定新的锁定核心版本。
2. 您可以取消核心版本的锁定，更新到最新版本的 Drupal。

要取消 Drupal 版本的锁定，请运行以下命令：

```php
composer require drupal/core-recommended drupal/core-composer-scaffold drupal/core-project-message --update-with-all-dependencies
```

## 运行数据库更新

为方便起见，我们附上了完成更新所需的[Drush](http://www.drush.org/)命令，很多人觉得 Drush 比网页管理界面更快更易用。

您可以使用 drush：

```php
drush updatedb
drush cache:rebuild
```

或者在浏览器中访问`<span class="token punctuation">[</span><span class="token constant">YOUR</span> <span class="token constant">DOMAIN</span><span class="token punctuation">]</span><span class="token operator">/</span>update<span class="token punctuation">.</span>php`。