Composer 无法直接安装官方 WordPress 主题，因其未在 Packagist 注册且主题非标准 PHP 包；需通过 wpackagist 镜像或自定义 composer.json + composer/installers 才能实现 Composer 管理。
为什么 composer require 装不了官方 WordPress 主题
WordPress 官方主题（如 twentytwentyfour）不在 Packagist 默认源里，直接 composer require wordpress/wp-content 或类似写法会报 Could not find package。不是命令写错，是生态定位问题：Composer 管理的是 PHP 依赖，而 WP 主题本质是文件结构 + 模板 + 钩子，官方没把它当“包”发布。
真正能走 Composer 安装的主题，必须满足两个条件：作者主动注册到 Packagist，且在 composer.json 中声明了正确的 type（如 wordpress-theme）和安装路径（install-path）。
- 绝大多数免费主题没做这一步，包括 .org 上下载的 zip 包，解压后也没有
composer.json - 部分商业主题或工具链（如 Roots Sage、WP Rig）自带
composer.json，可require，但只适用于它们自己的构建流程 - 别信“一键 composer 安装所有主题”的脚本——它只是帮你下载 zip 再解压，不是 Composer 原生行为
用 composer/installers 让自定义主题支持 require
如果你自己开发主题，或想把某个第三方主题纳入 Composer 流程，核心是靠 composer/installers 这个插件来接管安装路径。它不提供主题，只告诉 Composer：“当遇到 type: wordpress-theme 的包时，别扔进 vendor/，扔进 wp-content/themes/。”
操作分三步：
- 项目根目录运行
composer require composer/installers - 在主题项目的
composer.json里加：{"type": "wordpress-theme", "name": "vendor/my-theme"} - 在你的站点项目中
composer require vendor/my-theme，前提是该主题已推送到 Packagist 或配置了私有仓库
注意：installers 不解决主题依赖 PHP 扩展、WordPress 版本兼容等问题，它只管“放哪儿”。如果主题用了 get_template_directory() 硬编码路径，换 Composer 安装方式后可能出错。
wp-cli + composer 混合管理才是现实方案
纯 Composer 管理 WP 主题在生产环境极少单独使用，因为主题更新、启用、禁用、多站点切换这些动作，wp-cli 更直接可靠。常见做法是：用 Composer 下载/锁定版本，用 wp-cli 控制状态。
- 下载主题：
composer create-project wpackagist-plugin/twentytwentyfour web/wp-content/themes/twentytwentyfour --no-dev（需先配置 wpackagist.org 为 repo） - 启用主题：
wp theme activate twentytwentyfour --path=web - 更新主题：
composer update wpackagist-plugin/twentytwentyfour后，再wp theme update twentytwentyfour确保数据库标记同步
坑点：wpackagist.org 是社区维护的镜像，不是官方源，部分新主题上架有延迟；且它把所有主题都打成 wpackagist-plugin/xxx，命名和 WordPress.org 不一致，得查文档确认对应关系。
主题里的 functions.php 和 Composer 自动加载冲突吗
不冲突，但容易误用。Composer 的 autoload（如 psr-4）只负责类文件的自动引入，而 functions.php 是 WordPress 在主题加载时强制 include 的普通 PHP 文件，不会被 Composer 扫描或加载。
- 如果你在主题里写了命名空间类，想用 Composer 自动加载，必须在
composer.json中配好autoload段，并运行composer dump-autoload - 别试图把
functions.php改成class Functions {}然后指望自动加载——WordPress 不认这个 - 主题内调用
vendor/autoload.php是可行的（比如在functions.php开头require_once get_theme_file_path('vendor/autoload.php')），但要注意路径稳定性，尤其在子主题或部署路径变动时
真正容易漏掉的是：主题更新后，vendor/ 目录不会自动重建，autoload.php 可能失效。每次 composer install/update 后，得确认它是否还在主题目录里，而不是被 gitignore 掉或部署脚本跳过。
