MSBuild中Git命令格式字符解析异常，如何获取Git提交日期？

核心错误点 #

你遇到的问题主要源于MSBuild对特殊字符的解析规则和Git命令执行环境的配置遗漏：

1. MSBuild中%是特殊占位符，Git格式符里的%必须转义为%%，但如果引号处理不当，转义后的格式符会被shell错误截断。
2. Exec任务默认执行目录可能不是Git仓库根目录，导致Git命令执行失败，最终输出空值被后续逻辑处理为-。
3. git show退出码128通常是因为当前目录不在Git仓库内、无提交记录，或者权限不足。

分步排查与解决 #

1. 先验证Git命令本身是否正常

在项目根目录打开命令行，直接执行目标Git命令：

git log -1 --format="%ad"

如果该命令无法输出正确日期，先解决Git环境问题：

• 确认当前目录在Git仓库内（执行git status验证）
• 确认分支有至少一次提交记录

2. 修正MSBuild中Exec任务的写法

在.csproj中配置Exec任务时，需要注意三个细节：

• 所有Git格式符的%转义为%%
• 用单引号包裹Git格式字符串，避免MSBuild解析双引号时出现冲突
• 指定WorkingDirectory为Git仓库根目录（如$(ProjectDir)或$(SolutionDir)）

示例配置：

<Target Name="FetchGitCommitDate" BeforeTargets="CoreCompile">
  <!-- 获取提交日期（本地时区格式） -->
  <Exec Command="git log -1 --format='%%ad'" 
        WorkingDirectory="$(ProjectDir)" 
        ConsoleToMSBuild="true"
        IgnoreExitCode="false">
    <Output TaskParameter="ConsoleOutput" PropertyName="GitCommitDate" />
    <Output TaskParameter="ErrorOutput" PropertyName="GitCommandError" />
  </Exec>

  <!-- 输出错误信息用于排查 -->
  <Message Text="Git执行错误: $(GitCommandError)" Importance="High" Condition="'$(GitCommandError)' != ''" />

  <!-- 将日期写入程序集元数据 -->
  <AssemblyAttribute Include="AssemblyMetadata(&quot;GitCommitDate&quot;, &quot;$(GitCommitDate.Trim())&quot;)" />
</Target>

3. 解决git show退出码128问题

针对git show的错误，添加WorkingDirectory参数并确保命令格式正确：

<Exec Command="git show -s --format='%%ad'" 
      WorkingDirectory="$(SolutionDir)" 
      ConsoleToMSBuild="true" />

如果仍报错，执行git show命令行验证，排查是否存在：

• 仓库目录异常（.git文件夹损坏）
• 无提交记录（首次提交前git show无法执行）
• 权限不足（无法读取.git目录）

额外排查细节 #

• 查看MSBuild的详细构建日志：添加/v:d参数运行构建，可看到Exec任务执行的完整命令和输出，定位格式符是否被正确传递给Git。
• 测试不同的Git日期格式：比如%%cI（ISO 8601格式）、%%ai（UTC日期时间），确认转义后是否能正常输出。
• 检查是否有后续逻辑将空值替换为-：如果Git命令返回空，可能是后续的属性处理步骤将空值设为了-，需排查相关代码。

内容的提问来源于stack exchange，提问作者Lyndon Gingerich