分类

语义化版本校验器

验证版本号是否符合 Semantic Versioning 2.0.0 规范(x.y.z-alpha.1 格式)

关键信息

分类
Validation
输入类型
text
输出类型
text
样本覆盖
4
支持 API
Yes

概览

语义化版本校验器是一个轻量级在线工具,用于快速检查一个版本号字符串是否严格遵循 Semantic Versioning 2.0.0 规范。它能识别并验证主版本号、次版本号、修订号以及可选的预发布版本和构建元数据,确保版本格式的正确性。

适用场景

  • 在发布软件、npm包或任何遵循语义化版本控制的项目前,验证版本号格式是否正确。
  • 在自动化脚本或CI/CD流程中,需要确保传入的版本号参数符合规范时。
  • 在编写文档、配置文件或API响应时,需要确认引用的版本号格式无误。

工作原理

  • 在输入框中粘贴或输入需要验证的版本号字符串。
  • 工具将根据 Semantic Versioning 2.0.0 规范(格式为 X.Y.Z-预发布版本+构建元数据)解析输入。
  • 解析完成后,工具会立即显示该版本号是否有效,并指出格式错误的具体位置(如果无效)。

使用场景

软件发布前的版本号格式检查。
在包管理器(如npm、pip)的配置文件中验证依赖版本。
在版本控制系统的标签(tag)或发布说明中确保版本格式规范。

用户案例

1. 验证正式发布版本

开发工程师
背景原因
准备发布一个新版本的库,版本号定为 2.5.0。
解决问题
需要在发布前确认版本号格式完全正确,避免因格式问题导致包管理器拒绝。
如何使用
在输入框中输入 `2.5.0`。
效果
工具显示“有效”,确认这是一个符合规范的正式版本号。

2. 检查预发布版本格式

前端开发者
背景原因
项目需要发布一个内部测试版本,版本号计划为 1.0.0-rc.1+build.123。
解决问题
不确定预发布标签和构建元数据的组合写法是否正确。
如何使用
在输入框中输入 `1.0.0-rc.1+build.123`。
效果
工具显示“有效”,确认该版本号格式正确,可用于内部测试分发。

3. 识别无效版本号

运维人员
背景原因
在部署脚本中发现一个版本号参数 `v1.2.3`,不确定其是否有效。
解决问题
需要快速判断该版本号是否符合语义化版本规范,因为规范不允许前缀‘v’。
如何使用
在输入框中输入 `v1.2.3`。
效果
工具显示“无效”,并指出格式错误,帮助用户修正为正确的 `1.2.3`。

用 Samples 测试

validation

相关专题

常见问题

这个工具支持哪些版本号格式?

支持完整的语义化版本 2.0.0 格式,例如:1.0.0、2.1.3、3.0.0-alpha.1、4.0.0-beta+exp.sha.5114f85。

预发布版本标签(如 alpha, beta)有特定要求吗?

预发布版本标签必须由ASCII字母数字和连字符[0-9A-Za-z-]组成,且不能是空字符串。

构建元数据会影响版本的优先级吗?

不会。构建元数据(+号后的部分)仅用于标识构建信息,在版本比较时会被忽略。

如果版本号无效,会提示什么?

工具会明确指出输入的版本号不符合语义化版本规范,并可能高亮显示格式错误的部分。

可以一次性验证多个版本号吗?

不可以。本工具设计为单次验证一个版本号字符串,以确保结果的清晰和准确。

API 文档

请求端点

POST /zh/api/tools/semver-validator

请求参数

参数名 类型 必填 描述
version text -

响应格式

{
  "result": "Processed text content",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}
文本: 文本

AI MCP 文档

将此工具添加到您的 MCP 服务器配置中:

{
  "mcpServers": {
    "elysiatools-semver-validator": {
      "name": "semver-validator",
      "description": "验证版本号是否符合 Semantic Versioning 2.0.0 规范(x.y.z-alpha.1 格式)",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=semver-validator",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

你可以串联多个工具,比如:`https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`,最多20个。

如果遇见问题,请联系我们:[email protected]