修复 GitHub Actions 构建时版本号显示为 v0.0.0-0 的问题

[scorpionfree98]

描述

修复 GitHub Actions 构建时版本号显示为 v0.0.0-0 的问题，优化跨平台兼容性。

更改类型

• Bug 修复
• 代码重构
• 新功能
• 破坏性更改
• 文档更新
• 性能优化
• 测试

相关问题

修复 GitHub Actions 打包后版本号错误的问题。

更改内容

更改的文件

• .github/workflows/release.yml
• scripts/auto-version.js

主要更改

1. ci(workflow): 设置 fetch-depth 为 0 以获取完整提交历史

   • 在 actions/checkout@v4 步骤中添加 fetch-depth: 0
   • 解决 GitHub Actions 默认浅克隆导致无法获取 Git 标签的问题

2. refactor(scripts): 优化 git 命令执行方式以消除平台差异

   • 将 execSync 的命令字符串改为使用 shell: true 选项
   • 解决 Windows 环境下 Unix shell 语法不兼容的问题

3. refactor(scripts): 使用 spawnSync 替换 execSync 提高跨平台兼容性

   • 使用 spawnSync('git', args, options) 替代 execSync
   • 通过参数数组传递命令参数，避免 shell 解析差异
   • 封装 execGitCommand 函数统一处理 Git 命令执行

测试

描述你如何测试这些更改：

• 测试环境：Windows PowerShell / macOS Terminal
• 测试步骤：
  1. 在本地运行 node scripts/auto-version.js
  2. 验证是否正确显示 Git 标签、提交次数和短哈希
  3. 验证版本号是否正确生成（非 0.0.0-0）
• 测试结果：通过

截图

无

检查清单

• 我的代码遵循此项目的代码风格
• 我已执行自我审查
• 我已对代码进行了注释
• 我已更新了相应的文档
• 我的更改不会产生新的警告
• 我已添加了测试（如果适用）
• 新增和现有的单元测试都通过
• 任何依赖的更改都已合并和发布

其他信息

问题根因

1. GitHub Actions 默认使用浅克隆（fetch-depth: 1），不会拉取 Git 标签信息
2. auto-version.js 使用 Unix shell 特有的语法（2>/dev/null、||），在 Windows PowerShell 中无法正常工作

解决方案

1. 设置 fetch-depth: 0 获取完整 Git 历史记录
2. 使用 spawnSync 的数组参数形式执行 Git 命令，避免 shell 解析差异

提交记录

• a1b2c3d - ci(workflow): 设置 fetch-depth 为 0 以获取完整提交历史
• e4f5g6h - refactor(scripts): 优化 git 命令执行方式以消除平台差异
• i7j8k9l - refactor(scripts): 使用 spawnSync 替换 execSync 提高跨平台兼容性