[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

卸载语言包

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

有经验的
管理员
开发人员

本节讨论如何从文件系统卸载一个或多个语言包，或者包括语言包的代码。您可以先创建备份，以便以后恢复数据。

此命令仅卸载 中指定的 个composer.json语言包；换句话说，卸载作为编辑器包提供的语言包。如果您的语言包不是编辑器包，则必须通过从文件系统删除语言包代码来手动卸载它。

您可以随时使用magento setup:rollback命令恢复备份。

命令用法：

bin/magento i18n:uninstall [-b|--backup-code] {language package name} ... {language package name}

语言包卸载命令执行以下任务：

检查依赖关系；如果是，则命令终止。

要解决此问题，您可以同时卸载所有从属语言包，也可以先卸载从属语言包。
如果指定了--backup code，请将文件系统（不包括var和pub/static目录）备份到var/backups/<timestamp>_filesystem.tgz
使用composer remove从代码库中移除语言包文件。
清理缓存。

例如，如果您尝试卸载其他语言包所依赖的语言包，则会显示以下消息：

Cannot uninstall vendorname/language-en_us because the following package(s) depend on it:
      vendorname/language-en_gb

另一种选择是在备份代码库后卸载两种语言包：

bin/magento i18n:uninstall vendorname/language-en_us vendorname/language-en_gb --backup-code

与以下内容类似的消息：

Code backup is starting...
Code backup filename: 1435261098_filesystem_code.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Code backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_code.tgz
[SUCCESS]: Code backup completed successfully.
Loading composer repositories with package information
Updating dependencies (including require-dev)
  - Removing vendorname/language-en_us (dev-master)
Removing Magento/LanguageEn_us
  - Removing vendorname/language-en_br (dev-master)
  - Removing vendorname/language-en_br (dev-master)
Writing lock file
Generating autoload files

recommendation-more-help

0f8e7db5-0e9c-4002-a5b8-a0088077d995