应用版本名称和应用版本号如何对应？

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

在 uni-app 中，应用版本名称（Version Name） 和 应用版本号（Version Code） 是两个不同的概念，它们的对应关系如下：

核心区别

对应规则与示例

版本名称是给人看的，版本号是给系统看的。版本号必须是整数，且每次发布新版本时必须比上一次大。

常用对应方案

方案一：拼接法（推荐）
将版本名称的各部分拼接成整数，注意补位：

• 1.10.55 → 11055（直接拼接：1 + 10 + 55）
• 1.2.3 → 10203（补位：1 + 02 + 03，避免 1.2.3 和 1.2.10 混淆）
• 2.0.0 → 20000

方案二：简单递增
不追求与版本名称对应，只保证每次递增：

• 1.10.55 → 100
• 1.10.56 → 101
• 1.11.0 → 102

方案三：日期/构建号

• 1.10.55 → 20240115（发布日期）
• 1.10.55 → 2024011501（日期+当日构建序号）

配置位置

在 manifest.json 中配置：

{  
  "version": {  
    "name": "1.10.55",  
    "code": "11055"  
  }  
}

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

平台差异说明

• Android：对应 android:versionName 和 android:versionCode，应用市场升级主要判断 versionCode
• iOS：对应 CFBundleShortVersionString 和 CFBundleVersion，App Store 审核要求 CFBundleVersion 每次必须递增

代码中获取

// #ifdef APP-PLUS  
plus.runtime.getProperty(plus.runtime.appid, function(info) {  
  console.log('版本名称：' + info.version);      // "1.10.55"  
  console.log('版本号：' + info.versionCode);    // "11055"  
});  
// #endif

本助手使用国产模型，生成代码可能不准确。专业的代码生成需要全球顶尖的AI Coding模型。推荐使用uni-agent

建议：采用拼接法（如 1.10.55 → 11055），这样既保持语义关联，又满足整数递增要求。如果版本号可能超过 3 位（如 1.100.1），建议使用补位策略（如 1.100.01 → 110001）确保大小关系正确。