WordPress可通过wpackagist.org和composer/installers用Composer管理插件/主题：添加wpackagist仓库，require对应包，配置installer-paths映射至wp-content，注意手动激活及目录命名一致性。
WordPress 本身不原生支持 Composer，但可以通过社区维护的工具和约定，用 Composer 管理插件和主题——关键在于不直接依赖 WordPress.org 的 ZIP 包，而是使用 Packagist 上托管的、符合 WordPress 标准结构的包，或通过自定义仓库（如 wpackagist.org）拉取官方资源。
使用 wpackagist.org 自动同步官方插件/主题
wpackagist.org 是一个将 WordPress.org 插件和主题自动镜像为 Packagist 兼容包的服务。它每天同步，所有包命名遵循 wpackagist-plugin/插件slug 或 wpackagist-theme/主题slug 格式。
- 在
composer.json中添加仓库配置：
"repositories": [
{
"type": "composer",
"url": "https://www.php.cn/link/a6e79d4197c9f9927b4102dfcc472dcb"
}
]- 安装经典插件（如 Advanced Custom Fields）：
composer require wpackagist-plugin/advanced-custom-fields
- 安装主题（如 Twenty Twenty-Four）：
composer require wpackagist-theme/twentytwentyfour
安装后，插件/主题文件会出现在 vendor/wpackagist-plugin/ 或 vendor/wpackagist-theme/ 下，需配合自动加载器或符号链接将其映射到 wp-content/plugins/ 或 wp-content/themes/ 目录。
用 composer/installers 指定安装路径
仅靠 wpackagist 不够——默认安装到 vendor/，WordPress 不识别。需借助 composer/installers 插件，让 Composer 把特定类型包安装到指定位置。
- 先安装 installer：
composer require composer/installers
- 在
composer.json中声明自定义类型和路径映射：
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"],
"wp-content/themes/{$name}/": ["type:wordpress-theme"]
}
}注意：wpackagist 的包必须在 composer.json 中正确声明 "type": "wordpress-plugin"（它已预设），这样 installer 才能识别并投递到对应目录。
避免常见陷阱
- 不要直接 require wordpress/wp-* 包：这些是 WordPress 核心源码，不是插件，且无自动加载逻辑，无法直接启用；
- 插件更新后可能需手动激活：Composer 只负责文件部署，不调用 WordPress API 激活，首次安装或更新后仍需在后台点“启用”；
-
主题子目录名必须与 slug 一致：例如
require wpackagist-theme/twentytwentyfour会生成wp-content/themes/twentytwentyfour/，若目录名不符，WordPress 将无法识别； -
私有插件建议用 VCS 仓库：把 Git 仓库地址加进
repositories，设置"type": "package"并指定"dist"，更可控。
推荐最小可行工作流
- 初始化项目：
composer init，添加 wpackagist 仓库； - 装 installer：
composer require composer/installers； - 配置
installer-paths到wp-content子目录； - 按需
require插件/主题； - 提交
composer.lock和composer.json，不提交vendor/或wp-content（用 CI 或部署脚本运行composer install）。
基本上就这些。不复杂但容易忽略路径映射和激活步骤。
