不能直接用 composer require wordpress/theme-name 安装 WordPress 主题，因为官方主题目录不是 Composer 包源，也不在 Packagist 注册；必须通过自定义仓库（type: package 或 type: vcs）+ composer/installers 路径映射，才能让主题真正落到 wp-content/themes/ 并被 WordPress 识别。

不能直接用 composer require wordpress/theme-name 安装 WordPress 主题，因为官方主题目录不是 Composer 包源，也不在 Packagist 注册；必须通过自定义仓库（type: package 或 type: vcs）+ composer/installers 路径映射，才能让主题真正落到 wp-content/themes/ 并被 WordPress 识别。

为什么 composer require 直接报错“Could not find package”？

这是最常卡住的第一步。Packagist 默认只查 packagist.org，而 WordPress.org 主题页（如 https://wordpress.org/themes/twentytwentyfour/）不提供 Composer 兼容的 composer.json，也没有自动注册为 Packagist 包。

• composer require wpackagist-theme/twentytwentyfour 是可行的——但前提是已在 repositories 中声明了 https://wpackagist.org 镜像源
• composer require wordpress/twentytwentyfour 必然失败，这个命名不存在于任何官方源
• 即使你手动下载了主题 ZIP，composer require 也不会自动解压或识别它——必须先定义为 type: package 并写明 dist.url

用 wpackagist.org 安装免费主题的实操要点

这是最快落地的方式，适合从 wordpress.org 下载的免费主题（如 twentytwentyfour、astra、oceanwp），但配置稍有不慎就会装进 vendor/ 而后台看不到。

HR面试评价助手-Word版

🎯 HR面试评价助手（Word版格式） 生成可直接复制到Word文档的标准格式HR面试评价 【使用方式】 1. 发送口令：HR面试评价 2. 粘贴JD文字 3. 上传简历文档 4. 上传面试记录（可选） 5. 复制生成的评价到Word 【输出特点】 - 纯文本格式，可直接粘贴到Word - 层次清晰，标题加粗...

下载

• 在 composer.json 的 repositories 数组里加一行：{"type": "composer", "url": "https://wpackagist.org"}
• 运行 composer require wpackagist-theme/twentytwentyfour（注意前缀是 wpackagist-theme/，不是 wordpress/ 或 theme/）
• 确保已安装 composer/installers:^2.0（^1.x 不支持 wordpress-theme 类型）
• 在 extra.installer-paths 中明确写："wp-content/themes/{$name}/": ["type:wordpress-theme"] ——路径必须真实存在，且 wp-content 在项目根目录下（不是 web/wp-content 或 public/wp-content）
• 执行 composer install -v，确认日志里出现 WordPressInstaller::install，否则映射没触发

手动打包私有或付费主题时，type 和 dist.url 怎么填？

WPackagist 不收录付费主题（如 divi、avada）或你自研的主题，这时得走 type: package，但容易因字段缺失导致安装后不生效。

• type 必须是 wordpress-theme（不是 theme、library 或留空），否则 installer-paths 规则不匹配
• dist.url 要指向可公开访问的 ZIP 文件（GitHub Release、S3、甚至本地 HTTP 服务均可），且每次更新必须改 URL 或 dist.shasum，否则 composer update 不会拉新包
• version 建议用语义化版本（如 1.2.3），不要用 dev-master ——后者在 type: package 下不被支持
• 整个 package 定义要塞进 repositories 的 packages 数组里，格式严格，多一个逗号或少一个引号都会导致解析失败

composer update 不更新主题？先看这三处

主题“看起来没变”，往往不是命令没跑，而是缓存、校验或路径没对上。

• composer.lock 里锁死了 dist.shasum，哪怕 dist.url 指向的新 ZIP 内容已变，Composer 仍按旧哈希校验——删掉 composer.lock 再 composer install 可绕过（不推荐生产环境）
• GitHub Release 的 ZIP 链接带 commit hash（如 https://github.com/xxx/xxx/archive/refs/tags/v1.2.3.zip），你上传了新 ZIP 但没改 tag，URL 没变，Composer 就认为“没更新”
• 主题文件虽已复制到 wp-content/themes/，但目录名和主题 style.css 里的 Theme Name: 不一致，WordPress 后台会显示“损坏”，需人工启用——这不是 Composer 问题，但常被误认为安装失败

真正麻烦的不是怎么装，而是装完之后谁来保证 wp-content/themes/ 下的文件和 composer.lock 严格一致——尤其多人协作时，有人直接改主题文件却不提交 composer.lock，下次 composer install 就会覆盖掉那些改动。这点比路径配置更难管控。