如何使用日历版本控制更新package.json且避免npm篡改版本格式

问题原因 #

npm的version命令严格遵循语义化版本（SemVer）规范，而你使用的日历版本格式（如2024.02.19.0）不符合SemVer规则：

• 带前导零的数字段（如02）会被自动去除前导零，转为2
• 超过三段的版本号会被错误解析，19被当成预发布版本标识拆分为1-9，最终导致版本号格式混乱

可行解决方案 #

要保留日历版本格式，同时同步更新package-lock.json，可以在GitLab CI脚本中采用以下步骤：

1. 直接修改package.json的版本号 #

用脚本工具（如jq，大部分CI环境默认预装）精准修改版本字段：

# 替换为目标日历版本号
TARGET_VERSION="2024.02.19.0"
jq --indent 4 ".version = \"$TARGET_VERSION\"" package.json > temp.json && mv temp.json package.json

如果环境没有jq，也可以用sed命令（注意适配不同系统的语法）：

sed -i '' "s/\"version\": \".*\"/\"version\": \"$TARGET_VERSION\"/" package.json

2. 更新package-lock.json #

执行以下命令，仅同步package-lock.json的版本信息，不重新安装依赖：

npm install --package-lock-only

3. 提交版本变更（可选） #

如果需要将版本变更提交到Git，添加以下命令：

git add package.json package-lock.json
git commit -m "chore: bump version to $TARGET_VERSION"

注意事项 #

• 避免使用npm version命令直接设置日历格式版本号，因为它会强制转换为SemVer兼容格式
• 确保CI环境中安装了jq或sed工具，若未预装可在脚本中添加安装步骤（如apt-get install jq或brew install jq）

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