必须将本地包推送到公开GitHub/GitLab仓库并配置合法composer.json后，才能提交到Packagist；需确保仓库公开、含正确tag、Webhook启用且版本符合semver，再清除Composer缓存方可正常使用。
本地包没注册 GitHub/GitLab 仓库，根本没法提交到 Packagist
Packagist 不托管代码，只索引公开的 Git 仓库（GitHub、GitLab、Bitbucket）。你本地 vendor/myname/mypackage 文件夹再完整也没用——Packagist 根本看不到它。必须先把代码推送到一个带 HTTPS 克隆地址的公开仓库，并确保主分支（通常是 main 或 master）里有合法的 composer.json。
常见错误现象：
• 点击 Packagist 的 “Submit” 按钮后提示 “Repository not found” 或 “Invalid repository URL”
• 提交后状态一直卡在 “Pending verification”，几小时没反应
- 检查仓库是否设为 Public（私有库无法被 Packagist 抓取）
- 确认
composer.json在仓库根目录，且包含必需字段：name（格式必须是vendor/name，如myname/laravel-helper）、description、type（如library）、autoload - 首次推送前运行
git tag -a v1.0.0 -m "First release"
并git push origin v1.0.0
，否则 Packagist 可能无法识别版本
提交到 Packagist 后没自动更新？检查 Webhook 和 composer.json 版本规范
Packagist 默认通过 GitHub/GitLab 的 Webhook 自动拉取新 tag，但这个机制极易静默失败。不是点了 “Update” 就万事大吉。
关键点：
• Packagist 要求版本号严格遵循 semver 格式（如 v2.1.0、v0.9.5），1.0 或 dev-main 这类写法不会触发自动更新
• Webhook 必须在你的 Git 仓库 Settings → Webhooks 中启用，目标 URL 是 https://packagist.org/api/github（GitHub）或对应 GitLab 地址
- 手动触发更新：进入 Packagist 页面你的包详情页，点右上角 “Update” 按钮（需登录）
- 验证 Webhook 是否生效：GitHub 仓库 Settings → Webhooks → 点进对应 hook → 查看 Recent Deliveries 里的响应状态码，
200才算成功 - 如果用了 GitLab，确保 Packagist 账户已绑定 GitLab，并在 GitLab 项目设置中启用了 “Push events” 和 “Tag push events”
composer require 时提示 “Could not find package xxx at any version”
这通常不是 Packagist 同步问题，而是本地 Composer 缓存或网络策略干扰了元数据拉取。
执行顺序很重要：
• Packagist 页面显示 “Latest release: v1.0.0” ≠ 你的本地 composer 能立刻看到它
• Composer 默认缓存 repo 元数据（约 5 分钟过期），尤其在国内网络环境下可能更久
- 强制刷新 Packagist 元数据：
composer clear-cache && composer update --dry-run
- 临时跳过缓存查源：
composer show myname/mypackage -vvv
，观察日志里是否出现Reading composer.json of myname/mypackage (v1.0.0) - 若仍失败，尝试加
--repository=https://packagist.org显式指定源：composer require myname/mypackage --repository=https://packagist.org
想让别人 require 时自动加载类？autoload 配置必须精确到路径
composer.json 里的 autoload 写错，会导致 composer dump-autoload 生成的映射文件失效，require 后 Class not found。
最简可用配置示例（假设类文件在 src/Helper.php）：
{
"name": "myname/mypackage",
"autoload": {
"psr-4": {
"MyName\\MyPackage\\": "src/"
}
}
}
- 路径必须是相对于
composer.json的相对路径，src/末尾斜杠不能少 - 命名空间前缀（
MyName\\MyPackage\\）要和实际 PHP 文件中的namespace完全一致，包括大小写 - 改完
composer.json后，务必在包根目录运行composer dump-autoload
，再测试require - 别用
classmap做临时方案——它不支持自动发现新文件，每次增删类都要重跑dump-autoload
