iOS 版本号与构建号有什么区别?用一条例子写清测试反馈
测试群里有人说“我装的就是 2.3.0,修复没生效”,开发者电脑上也显示 2.3.0。先让双方补齐括号里的构建号。2.3.0(41)与 2.3.0(42)可以是同一发行版本的两次交付。再确认平台和应用身份,才能判断对方是否真的复测了修复所在的那一版。
三个字段各解决什么问题?
Bundle ID 用来区分应用,例如示例中的 com.example.notes。开发版与正式版若使用不同标识,即便桌面图标和应用名称很像,也要到对应的应用记录查找。版本号 CFBundleShortVersionString 表示用户可识别的发行版本。构建号 CFBundleVersion 标识一次构建迭代。App Store Connect 在处理上传时用 Bundle ID 和版本号对应应用与版本记录,再用构建字符串区分具体构建。
Stack Overflow 上关于这两个版本字段如何赋值的提问,反映的是一个真实维护问题:一次发布前反复测试,是否每次都要换用户看到的版本?团队可以让多次构建服务于同一个发行版本,并使每次上传的构建可区分。实际取值和提交规则按 Apple 的字段定义和上传要求处理,别直接照搬旧帖子里的编号格式。
社区原帖 · 两个版本字段怎样赋值 · Apple · CFBundleVersion 字段定义

一份交付记录,怎样发现“回归”其实还没复测?
假设周一外部体验组收到 2.3.0(41),首次打开相册并点“暂不允许”会回到首页。周二开发者修复这一分支,上传 2.3.0(42)。周三客户报告“2.3.0 还有同一个问题”。先请他在 TestFlight 或应用内的版本信息里确认构建,再问是否从同一个测试组取得。如果截图显示 41,应检查分发和更新;如果确实是 42,才进入修复验证。
即使拿到了 42,还要核对测试条件。客户的手机可能已经允许访问相册,开发者却在一台首次请求权限的设备上复查。在问题单中加上“权限初始状态”和“本次点了哪个按钮”,能区分代码仍有缺陷,还是新旧测试实际上走了不同分支。应用没有展示构建号时,测试者可以附安装详情,由开发者从交付记录补齐,不必要求客户去查工程文件。
可以直接贴进工单的例子
便笺测试版,iOS,2.3.0(42),通过客户体验组安装。周三 14:20(北京时间),第一次打开空白草稿,点添加照片,在权限弹窗选择暂不允许。预计留在编辑页,实际返回首页。相同初始条件下试了三次,其中两次出现。
把这个例子改成团队的格式时,保留安装入口、实际构建、预期行为和实际行为,系统版本与机型填写实测值。对开发者而言,上述信息决定复现顺序;对发包同事而言,组名和构建号能查出修复是否交到了客户手里。一个“已修复”勾选框无法替代这两端的记录。
什么时候只记版本和构建号仍然不够?
如果同一归档为不同的设备名单重新导出 Ad Hoc 包,代码和构建号可能完全相同,能够安装的设备却变了。这时交付表还要记导出批次、时间或文件摘要。相反,如果要查某次崩溃,就要保留该构建对应的归档及符号资料,由开发团队匹配报告。两种情况都能标成 2.3.0(42),附加记录取决于你在追查安装失败还是程序运行失败。
把修复闭环交还给最初报错的人
开发者在原问题单留下首次包含修复的构建号,发布负责人确认目标组可以安装,再请原测试者按同样步骤复测。回复应写“42、拒绝权限、连续三次均停留在编辑页”,这样后来查版本的人能理解结论成立的条件。若仍然退出,就把同一条记录转入TestFlight 崩溃反馈排查,保留已有的构建号和现场。