homepage字段仅作元数据展示，不影响安装加载：用于Packagist页面链接、composer show输出及第三方工具展示，必须为完整URL，不参与任何逻辑判断且修改后需触发reindex才更新。
composer.json 中的 homepage 字段纯粹是元数据，不影响任何安装、加载或依赖行为，只用于包信息展示（如 Packagist 页面、composer show 输出）。
homepage 字段的作用场景
它唯一生效的地方是：
– Packagist.org 上该包的详情页顶部显示的「Homepage」链接
– 运行 composer show vendor/package 时，输出中会列出 homepage 对应的 URL
– 第三方工具（如某些 IDE 插件或内部包管理系统）读取 composer.json 元数据时可能展示该字段
它不会：
– 影响自动加载（autoload）
– 被 Composer 命令解析或跳转
– 替代 repository 或 source 配置
– 在 require/install 时被访问或校验
正确写法与常见错误
字段值必须是字符串，且建议为完整、可访问的 URL（含协议）：
{
"name": "myorg/my-package",
"description": "A sample package",
"homepage": "https://myorg.github.io/my-package"
}
容易踩的坑包括：
– 写成相对路径（如 "homepage": "/docs"）→ Packagist 显示异常，点击 404
– 漏掉 https://（如 "homepage": "myorg.github.io/my-package"）→ 被当作文本而非链接，部分 UI 不渲染为超链接
– 指向不存在的页面或临时测试地址 → 降低包可信度
– 与 support.source 或 repository 混淆使用 → 它们用途完全不同
与其他字段的关系和优先级
homepage 是独立字段，不参与任何逻辑判断。但注意：
– 若同时设置了 support.source（如 GitHub 仓库地址），Packagist 会优先用它生成「Source」按钮；homepage 仅控制「Homepage」按钮
– repository 字段定义源码位置，Composer 依赖它拉取代码；homepage 对此毫无影响
– 如果你希望用户点击后看到文档，就填文档首页；想引导到官网，就填官网域名；别为了“凑数”随便写个 404 页面
真正容易被忽略的是：这个字段一旦发布到 Packagist，修改后不会实时更新——需要触发 reindex（比如推新 tag 或手动 sync），而且旧版本的 composer show 输出仍基于当时发布的 composer.json 快照。
