不能，Composer脚本本身不支持直接打Git tag，只能通过exec或shell命令调用git tag和git push等外部工具实现，且需确保环境已安装Git、配置权限并推送至远程仓库。
Composer脚本能直接打 Git tag 吗？不能，但可以调用 shell
Composer 的 scripts 本质是命令行指令的封装，不自带 Git 操作能力。它只能通过 exec 或直接写 shell 命令触发外部工具。所以「打标」这件事，得靠 git tag 和 git push 配合完成，Composer 只负责调度。
常见错误是以为在 composer.json 里写个 "tag": "git tag" 就完事——实际执行时往往报 Command "git" is not found（尤其 CI 环境没装 Git）或权限不足（比如没配 SSH key）。务必先确认运行环境有 Git 且可写远程仓库。
- 确保
git在 PATH 中（CI 中常需显式安装，如 GitHub Actions 加actions/checkout@v4） - 打标前建议校验当前分支（例如只允许在
main或release/*上操作） - 标签名应与
version字段一致或按规则生成，避免手动输错
怎么让 composer run-script 自动读取并使用 package version？
Composer 不会自动把 composer.json 里的 version 注入到脚本参数里，必须手动提取。最可靠的方式是用 jq 解析 JSON，或用 PHP 脚本读取 —— 后者更兼容（不用额外依赖 jq）。
推荐在项目根目录放一个 bin/tag.php：
<?php $composer = json_decode(file_get_contents('composer.json'), true);
$version = $composer['version'] ?? null;
if (!$version) {
die("Missing 'version' in composer.json\n");
}
system("git tag -a v{$version} -m 'Release v{$version}'");
system("git push origin v{$version}");
然后在 composer.json 中定义脚本：
"scripts": {
"tag": "php bin/tag.php"
}
- 注意
version必须是稳定格式（如1.2.3），不能是dev-main或含-dev后缀，否则 tag 名非法 - 如果想支持预发布（如
1.2.3-beta.1），Git tag 允许，但需确认下游工具（Packagist）是否接受该版本约束 - 执行前建议加
git status --porcelain检查工作区干净，否则 tag 可能打在脏提交上
为什么 run-script 打的 tag 在 Packagist 上不显示？
Packagist 不监听本地 git tag，只响应你向它配置的 GitHub/GitLab 仓库发送的 tag push 事件。也就是说：仅运行 composer run-script tag 是不够的，必须确保脚本里包含 git push origin <tag></tag>，且 Packagist 已绑定该仓库并启用 auto-update。
典型遗漏点：
- 脚本里只有
git tag，漏了git push（最常见） - Packagist 项目设置页未勾选
Update automatically - Webhook 被防火墙拦截（私有 GitLab 需手动配置回调地址）
- Tag 名不匹配 Packagist 的版本识别规则（例如用了
v1.2.3，但composer.json写的是1.2.3，推荐统一不带v前缀）
CI 场景下怎么安全地自动化打标？
本地手动跑 composer run-script tag 风险低，但 CI（如 GitHub Actions）里自动触发需加锁：不能每次 push 都打标，而应只响应特定分支或标签推送事件。
例如在 GitHub Actions 中，用 on.push.tags 触发构建，再在 job 里执行：
- name: Tag release
if: startsWith(github.event.ref, 'refs/tags/')
run: |
git config --global user.name 'github-actions'
git config --global user.email 'github-actions@github.com'
composer run-script tag
关键控制点：
- 用
if条件限制仅 tag 推送时执行，避免分支推送误触发 - CI 环境默认 checkout 是
--depth=1，需加fetch-depth: 0才能读到历史 tag - 别在脚本里硬编码
git push，CI token（${{ secrets.GITHUB_TOKEN }}）通常只对当前 repo 有 push 权限，跨 repo 会失败
真正麻烦的不是命令怎么写，而是版本语义、Git 状态、远端权限、Packagist 配置这四者要严丝合缝。少一环，tag 就卡在本地。
