Composer项目中应通过解析composer.json获取版本号而非硬编码，使用PHP命令校验语义化格式后打v前缀Git标签，并确保工作区干净、标签未重复，最后手动确认推送。
在 Composer 项目中，可以通过定义 scripts 来自动化版本发布前的 Git 标签操作。核心思路是：用 Composer 脚本调用 Shell 命令（如 git tag），并配合变量（如 $VERSION）或动态读取版本号，确保标签与 composer.json 中的 version 字段一致。
确认版本号来源：优先读取 composer.json
不要硬编码版本号。Composer 提供了内置变量 {$version}，但它只在包被安装时可用，**不适合在本地发布脚本中直接使用**。更可靠的方式是用命令行工具解析 composer.json：
- Linux/macOS：用
jq工具提取version字段，例如：jq -r '.version' composer.json - Windows（无 jq）：可改用 PHP 一行命令：
php -r "echo json_decode(file_get_contents('composer.json'))->version;" - 注意：确保
composer.json中的version字段已手动更新为待发布的版本（如"1.2.0"），这是语义化发布的前提
编写安全的打标签脚本（含校验）
避免重复打标签或误操作。推荐在 composer.json 的 scripts 中定义一个带检查的脚本：
"scripts": {
"release:tag": [
"@release:check-version",
"git tag -a \"v{$VERSION}\" -m \"Release v{$VERSION}\"",
"git push origin \"v{$VERSION}\""
],
"release:check-version": "php -r \"\$v = json_decode(file_get_contents('composer.json'))->version; if (!\$v || !preg_match('/^\\\\d+\\\\.\\\\d+\\\\.\\\\d+(-[a-z0-9]+)?$/', \$v)) { die('Invalid version format in composer.json\\n'); } echo \"Using version: \$v\\n';\""
}
说明：
-
release:check-version先校验version是否符合语义化版本格式（如1.2.0或1.2.0-beta.1） -
release:tag使用{$VERSION}—— 这里需在运行时通过环境变量传入，例如：VERSION=$(php -r \"echo json_decode(file_get_contents('composer.json'))->version;\") composer release:tag - 标签名加
v前缀（如v1.2.0）是主流约定，GitHub/GitLab 自动识别为 Release
整合到完整发布流程（可选）
把打标签作为多步骤发布的一部分，比如：
- 更新
composer.json中的version - 提交变更（如
git commit -am "chore: bump to v1.2.0"） - 运行脚本：
VERSION=$(php -r "echo json_decode(file_get_contents('composer.json'))->version;") composer release:tag - 后续可追加打包、发布到 Packagist 等步骤（用
composer publish等自定义脚本）
注意事项与避坑
常见问题要提前预防：
-
Git 工作区必须干净：建议在脚本开头加
git status --porcelain检查，非空则中止 -
标签已存在时会失败：加
-f强制覆盖不推荐；更稳妥的是先查：git rev-parse v{$VERSION} >/dev/null 2>&1 || git tag ... - Windows 用户注意路径和引号：PowerShell 对单引号处理不同，建议统一用 CMD + 双引号，或改用 PHP 脚本封装逻辑
-
别把敏感操作写死在 scripts 里：如自动 push，应明确提示用户确认，或拆分为
release:tag和release:push-tag两步
基本上就这些。关键不是脚本多复杂，而是让版本号来源可信、操作可逆、失败有提示。Composer 脚本只是胶水，真正可靠的是你对 Git 和语义化版本的理解。
