如何修复“无法安装软件包。主题缺少 style.css 样式表” WordPress 中的错误

您是否只是尝试将主题上传到您的 WordPress 站点,结果却收到一条消息,告诉您“无法安装包。主题缺少 style.css 样式表?”

如果您终于为您的网站找到了完美的主题,但如果您无法安装它并开始设计您的网站,那肯定会令人沮丧。值得庆幸的是,您可以执行一些简单的故障排除步骤来修复丢失的主题样式表错误,这样您就可以成功安装所需的 WordPress 主题。

在本文中,我们将解释此错误消息的含义以及您可能遇到它的一些原因。然后,阅读其中一些额外的故障排除步骤,以帮助您解决网站上的问题并成功更改您的 WordPress 主题。

什么是“无法安装包。主题缺少 style.css 样式表”错误?

为确保我们在同一页面上处理相同的问题,让我们快速了解此错误发生的时间及其外观。
唯一会发生此错误的情况是,如果您通过仪表板将自定义主题上传到您的 WordPress 网站:

  1. 进入外观→主题→添加新打开“添加主题”界面。
  2. 单击上传主题按钮打开文件选择器。
  3. 选择您从主题开发者处下载的 zip 文件(或者您自己创建的主题)。
  4. 单击立即安装按钮。

如果一切顺利,WordPress 将安装主题并在安装过程完成后为您提供激活它的选项。
但是,如果出现问题,您可能会看到一条消息“无法安装包。主题缺少 style.css 样式表”,然后是另一条消息“主题安装失败”。

因为 WordPress 未能安装主题,您将无法激活它,并且当您访问WordPress 仪表板中的外观 → 主题时,您将看不到主题。

“无法安装包。主题缺少 style.css 样式表”是什么意思?

要了解此错误消息的含义及其发生原因,我们首先需要快速了解一下 WordPress 主题的构造方式。
当您将高级或自定义主题上传到您的 WordPress 网站时,您可以通过上传单个 zip 文件来实现。但是,在该核心 zip 文件中,有很多不同的文件。
大多数 WordPress 主题文件都是用 PHP 编写的,这是 WordPress 使用的编码语言。但是,为了控制这些文件的布局和样式,您的主题使用了 CSS,它主要包含在 style.css 文件中。
让我们用一个人穿衣服的类比来说明您的 WordPress 主题和 style.css 文件发生了什么。
在这个类比中,主题的许多 PHP 文件都是真实的人。然后,style.css 文件就是这个人所穿的衣服。
如果你是人,在公共场合外出时需要穿衣服。而且,如果您是 WordPress 主题,如果您想要创建访问者可以实际使用的公共网站,则需要 style.css 文件。
因为没有 style.css 文件的 WordPress 主题就像一个人不穿衣服在公共场所走来走去,所以 WordPress 不会让您安装缺少 style.css 文件的主题。
现在很明显的问题是,为什么您的主题缺少 CSS 样式表?

为什么您的 WordPress 主题缺少 style.css 样式表?

style.css 文件是绝对必要的主题文件,因此 WordPress 主题开发人员不小心忘记将该文件包含在他们的主题之一中的可能性极低。
相反,最可能的原因是您没有上传正确的文件或文件实际上不是 WordPress 主题。这里有些例子:

  1. 您可能需要提取从主题开发人员/市场下载的 zip 文件以找到主题的实际 zi​​p 文件:由于 ThemeForest 处理下载的方式,这在 ThemeForest 主题中尤其常见。
  2. zip 文件可能用于插件而不是主题:这也很常见,因为许多主题都依赖于插件扩展来提供高级功能,因此很容易将它们混在一起。
  3. 主题可能不是为 WordPress 构建的:许多其他网站构建平台都提供主题,因此您可能不小心找到了用于不同平台的主题。

如果您尝试为您的站点已在使用的主题上传WordPress 子主题,您也可能会遇到此问题。或者,如果您正涉足 WordPress 主题开发,您可能不小心将 style.css 文件放在了错误的文件夹中。

如何修复丢失的 WordPress 主题样式表

现在,让我们深入研究 WordPress 缺少主题样式表错误的最常见修复方法。

1. 确认您正在上传正确的 zip 文件。

此错误的一个常见原因是您不小心将错误的 zip 文件上传到您的站点。一些主题开发人员为您提供了一个可下载的 zip 文件,其中包含多个不同的文件——不仅仅是您的主题。
为了访问特定主题的 zip 文件,您需要在综合 zip 文件中找到并上传单个主题文件。由于 ThemeForest 处理其下载的方式,这在 ThemeForest 中最为常见,但在其他情况下也可能发生。
对于此示例,假设您从 ThemeForest 购买了一个新主题。完成购买后,您可能已经转到仪表板,单击“下载”按钮,然后选择“所有文件和文档”。

这会将一个 zip 文件下载到您的计算机,因为您直接从 ThemeForest 下载了该 zip 文件,您可能会认为您可以将它上传到您的 WordPress 站点。
但是有一个问题。此 zip 文件不是实际可安装的主题文件。相反,它包含文档、许可证信息和其他所有内容。
如果您尝试将其上传到 WordPress,您可能会遇到缺少样式表消息,因为文件结构与 WordPress 的预期不匹配。
要访问实际的主题文件,您需要提取此文件并在其中找到实际的主题文件:

或者,在 ThemeForest,您可以选择只下载 WordPress 可安装文件。
如果您不确定自己是否拥有正确的 zip 文件,请查看以下内容:

  1. 当您第一次打开 zip 文件时,您应该会看到一个带有主题名称的文件夹。
  2. 当您打开该文件夹时,您应该会看到名称类似于index.php和functions.php的文件。您还应该看到一个名为style.css的文件。

这是打开 Avada 主题文件时的样子:

如果结构类似于上面的示例,则您知道您拥有正确的 zip 文件。

2. 确保该文件用于主题而非插件。

有时,WordPress 主题和WordPress 插件之间的界限可能会变得有点模糊。因此,您可能会遇到这样的情况:您认为您正在尝试安装主题,但扩展实际上是一个插件。
例如,假设您购买了 Astra 主题的高级版:Astra Pro。因为您购买了高级版,您可能会认为您应该像安装任何其他主题一样安装它。
然而,事实并非如此,因为 Astra Pro 实际上是一个插件,它扩展了 WordPress.org 上提供的免费 Astra 主题。
所以如果你想使用 Astra Pro,设置过程实际上是这样的:

  1. 从 WordPress.org 安装免费的 Astra 主题。因为它列在 WordPress.org 上,所以您不需要自己上传 zip 文件。相反,只需转到外观 → 主题 → 添加新的并按名称搜索它。
  2. 通过转到插件 → 添加新插件并上传您从 Astra 网站下载的 zip 文件来安装 Astro Pro 插件。

许多其他流行的主题也对其高级版本使用相同的方法,因此这可能是样式表丢失问题的一个非常常见的原因。
例如,GeneratePress Premium 是扩展 WordPress.org 上免费的 GeneratePress 主题的插件,Kadence Pro 是扩展 WordPress.org 上的免费 Kadence 主题的插件,等等。

3. 检查主题是否与 WordPress 兼容。

虽然 WordPress 是迄今为止最流行的网站制作方式,但它绝对不是唯一的平台。
您还有其他开源工具,例如 Drupal 和 Joomla,以及SaaS 网站构建器,例如Wix和Squarespace。
这是棘手的事情。
大多数其他平台也有“主题”,一些主题市场出售多个平台的主题。
例如,以 ThemeForest 为例。虽然大多数人都知道 WordPress 主题的 ThemeForest,但它也有 Joomla 主题、Drupal 主题、Squarespace 主题、纯 HTML 主题等的繁华市场。
如果您没有专门为 WordPress 主题设置过滤器,则可能会不小心为不同的平台选择了一个主题。
如果您尝试将不同平台的主题上传到 WordPress,您可能会看到“无法安装包。主题缺少 style.css 样式表”错误,因为文件的结构与 WordPress 的预期不匹配。

4. 确保您上传的是有效的子主题。

到目前为止,我们主要假设您在上传全新的 WordPress 主题时看到此错误消息。但是,当您尝试为您的站点正在使用的现有主题上传子主题时,您也可能会遇到此错误。
WordPress 子主题不是一个完整的主题。相反,它从您已经使用的主题(即父主题)继承了所有细节和样式。
使用子主题的优点是它可以让您安全地更改父主题,而不会在更新父主题时覆盖这些更改。
与普通主题不同,子主题只需要包含两个文件即可生效:

  1. 函数.php
  2. 样式.css

如果您不在子主题中包含 style.css 文件,它会触发缺少样式表消息,就像您上传了一个缺少样式表的常规主题一样。
如果您正在创建子主题,请确保严格按照上传说明进行操作,因为您需要使用一个确切的结构。或者,您也可以使用专用的子主题生成器插件(例如Child Theme Configurator)来简化子主题。

5. 将 style.css 文件放在根文件夹中。

如果您刚刚开始自定义 WordPress 主题开发,您可能不小心将主题的style.css文件放在了错误的文件夹中。
通常,您希望将style.css文件放在主题的根文件夹中,该文件夹与包含functions.php文件的文件夹相同。
如果您将文件放在不同的位置,WordPress 可能无法检测到它,这将导致 WordPress 显示错误消息。

永久修复 WordPress 缺少样式表错误

如果您尝试在 WordPress 站点上安装新主题,遇到“无法安装包。主题缺少 style.css 样式表”错误可能会令人沮丧。
值得庆幸的是,您可以按照一些简单的故障排除步骤来找出问题并让您的主题正常工作。
最常见的问题是您不小心上传了错误的文件,要么是因为您需要解压缩 zip 文件(对于 ThemeForest 主题很常见),要么是因为您正在尝试安装插件格式的高级版主题作为主题。

Newsletter Updates

Enter your email address below and subscribe to our newsletter

留下评论

您的电子邮箱地址不会被公开。 必填项已用 * 标注