Composer如何发布包到Packagist_Composer发布包到Packagist教程【必备】
发布包到 Packagist只需提交公开Git仓库URL，确保composer.json合规（name符合vendor/package、无version、有autoload、声明PHP依赖）、Git有合规语义化Tag（如v1.0.0）并推送至远程。 很多开发者第一次发布包时，可能会下意识地去找“上传
发布包到 Packagist只需提交公开Git仓库URL，确保composer.json合规（name符合vendor/package、无version、有autoload、声明PHP依赖）、Git有合规语义化Tag（如v1.0.0）并推送至远程。
很多开发者第一次发布包时，可能会下意识地去找“上传”按钮。其实，这里有个关键认知需要转变：Packagist本身并不存储你的代码。它更像一个智能的目录索引服务，专门抓取并解析那些公开的Git仓库。所以，你的核心任务不是上传文件，而是确保你的Git仓库“达标”，然后把仓库地址提交给Packagist——剩下的，它会自动处理。
你的 composer.json 必须通过 Packagist 的基本校验
这份文件是你的包的“身份证”和“说明书”，Packagist在首次抓取时会进行严格审查。以下几个要素缺一不可，任何一个出错都可能导致提交失败：
name字段：必须存在，并且严格遵循vendor/package的格式（例如myorg/my-utils）。注意，通常建议使用小写字母和连字符，大写字母或下划线可能会带来不必要的麻烦。version字段：这里有个常见的误区——千万不要在composer.json里手动写死版本号。包的版本由Git tag唯一决定，写死它反而会导致同步混乱或失败。autoload配置：这是包的“灵魂”。你至少需要定义一种自动加载方式（比如最常见的"psr-4": {"MyOrg\\": "src/"}），否则用户安装后，代码根本无法被自动加载和使用。- PHP依赖声明：如果你的包用到了某些特定的PHP版本或扩展，务必在
require中声明最低版本（例如"php": "^8.1"）。忽略这一步，你的包可能会被标记为“不兼容”，影响其他开发者的使用判断。
Git 仓库必须公开 + 有语义化 Tag
Packagist与你的Git仓库打交道，有一套明确的规则。它不会去拉取main或master分支的某个随机快照，它只认一个东西：Git tag。没有tag，你的包在Packagist眼里就“不存在”。
- Tag的命名：必须符合语义化版本规范（SemVer），例如
v1.0.0或1.2.3。像v1.0或dev这类不规范的命名会被直接忽略。 - Tag的推送：本地打tag只是第一步，切记要推送到远程仓库：
git tag v1.0.0 && git push origin v1.0.0。 - 仓库的公开性：你的仓库必须在GitHub、GitLab或Bitbucket等平台上设置为公开状态，私有仓库是无法被Packagist抓取的。
- 一个重要的提醒：如果你事后修改了某个已有tag指向的提交（比如使用了force-push），Packagist并不会自动感知这个变化。此时，你需要手动到Packagist的包管理页面点击“Update”按钮来触发更新。
在 Packagist 上提交仓库后，别等“自动同步”
提交仓库URL后，流程通常很快，几秒钟内就能完成首次抓取和上线。但以下几个“卡点”经常让开发者停滞不前：
- 如果包页面显示“This package is not auto-updated”，那基本可以断定是Webhook配置出了问题。你需要到Git仓库的设置页面（如GitHub的Settings → Webhooks），添加Packagist的Webhook地址：
https://packagist.org/api/github，内容类型选择application/json，并且通常只需勾选Releases事件即可。 - 假如提交后一直显示“Package not found”，别慌。建议先在本机用
composer validate命令检查composer.json的合法性，然后再确认tag是否真的推送成功了（运行git ls-remote --tags origin查看远程tag列表）。 - 首次成功后，后续发布新版本（打新tag）按理应该自动同步。但这完全依赖于Webhook的成功触发。如果没配Webhook，每次更新都只能回到Packagist页面手动点击“Update”。
最后，必须强调一个最容易被忽略，也最关键的事实：Packagist不验证你的代码逻辑，也不运行任何测试。它的校验范围仅限于composer.json的结构、tag的存在性以及autoload的配置是否可用。这意味着，哪怕你的src/目录是空的，只要composer.json通过了校验，包也能成功发布并被安装。当然，用户在执行require后，很快就会遇到Class not found的错误。所以，确保代码本身正确可用，始终是你的责任。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台，提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具，适合短剧、漫剧、广告及社交媒体内容制作。
Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，