如何通过Azure DevOps构建流水线动态更新package.json版本

问题根因 #

你遇到的报错是两个核心原因共同导致的：

1. 版本号不符合npm的SemVer规范要求：npm严格遵循语义化版本2.0规则，版本号的主、次、修订三个段都必须为非负整数，且不允许存在前导零。你生成的版本号202111.04.1901中，次版本段为04带有前导零，直接触发npm的参数校验失败。
2. 流水线变量插值时机错误：你在全局变量区定义的packageVersion会在流水线初始化阶段就完成插值计算，后续PowerShell任务修改major/minor/patch/rev的值，不会触发packageVersion自动更新，大概率你实际运行时拿到的是初始值10.0.0，而非你预期的动态日期版本。
3. 可选排查点：报错日志中npm的当前工作目录为/home/vsts/work/1/s/libs/my-library，和你配置的libs/my-package不一致，若路径不匹配找不到package.json也会触发同类型报错，需要先核对路径正确性。

解决方案 #

1. 调整变量生成逻辑 #

直接在PowerShell脚本中完成版本号的计算，去除前导零后再设置为流水线变量，规避插值时机问题：

steps:
  - task: PowerShell@2
    displayName: 计算版本号
    inputs:
      targetType: 'inline'
      script: |
        $yearMonth = Get-Date -Format "yyyyMM"
        # 转换为整数自动去除前导零
        $day = [int](Get-Date -Format "dd")
        $rev = [int](Get-Date -Format "HHmm")
        $finalVersion = "$yearMonth.$day.$rev"
        Write-Host "生成版本号: $finalVersion"
        # 输出为流水线变量，后续任务可直接引用
        Write-Host "##vso[task.setvariable variable=packageVersion]$finalVersion"

2. 调整npm任务配置 #

核对工作目录路径，直接引用上述生成的版本号变量即可：

- task: Npm@1
    displayName: 更新包版本
    inputs:
      command: 'custom'
      # 务必和仓库中package.json所在的实际路径一致
      workingDir: 'libs/my-package'
      customCommand: 'version $(packageVersion) --no-git-tag-version --loglevel verbose'

特殊场景适配 #

如果业务要求必须保留日、时间段的前导零，可以将前导零部分放到SemVer允许的构建元数据段，格式示例为202111.4+04.1901，同样可以通过npm校验。

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