Hyperledger fabric-samples版本标签是什么？为何要检出正确版本？

版本标签（version tag）定义 #

• 版本标签是Hyperledger Fabric官方为每一个正式发布版本在fabric-samples仓库上打的不可变快照标记，标签编号和对应发布的Fabric二进制程序、Docker镜像版本严格一一对应，标签指向的代码经过官方完整测试，不存在未完成的开发特性。

必须执行标签切换操作的原因 #

• 直接执行git clone拉取fabric-samples仓库时，默认检出的是main主分支代码，主分支为日常开发迭代状态，代码逻辑会随新版本开发持续变动，和用户本地安装的正式版Fabric二进制、镜像往往存在接口、参数、逻辑的不兼容，是导致test-network启动失败、链码部署异常、节点版本校验不通过的高频诱因。
• 例如本地安装2.2长期支持版Fabric组件时，若直接使用主分支的test-network脚本，脚本可能调用2.4之后版本才新增的命令参数，运行时会直接抛出参数不存在的报错。

checkout操作执行方式 #

1. 进入本地fabric-samples仓库的根目录，先查询仓库所有可用的正式版本标签，执行命令：

   git tag -l
   

2. 选择和本地安装的Fabric版本号完全一致的标签（例如本地安装Fabric 2.2.14则对应标签为v2.2.14），执行切换命令：

   git checkout v2.2.14
   

操作提示：如果之前修改过仓库内的脚本文件，切换前可以先执行git stash暂存本地改动，避免分支切换冲突。

操作结果校验 #

• 切换完成后执行git status，输出内容包含HEAD detached at <你选择的版本标签>时，即代表切换成功，后续再按文档启动test-network即可规避版本不匹配问题。

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