Qt项目一旦进入多人协作，最容易出现两类混乱：一类是把构建产物和个人配置提交进仓库，导致每个人拉下来都一堆脏文件；另一类是分支与版本号没统一口径，改动散落在各处，回滚与发布都很难复盘。把仓库边界、忽略规则、分支节奏和Qt Creator里的Git入口一次配置到位，版本管理会清爽很多。

　　一、Qt项目怎么做版本管理

　　版本管理先从仓库里到底该放什么开始定规则，再把目录结构和版本标签固定下来，这样后续换电脑、换Kit、换构建系统也不容易把仓库搞乱。

　　1、先定仓库边界只收源码与可复现资产

　　把src、resources、CMakeLists.txt或pro文件、必要的脚本与文档放进仓库，构建目录、安装目录、导出包与日志都不进仓库，构建目录放在源码树外更不容易误提交。

　　2、统一目录结构避免把生成物混进源码

　　常见做法是仓库根目录只放源码与配置，构建输出统一到repo同级的build目录或固定规则命名的build-xxx目录，团队统一约定后，任何人一眼就能判断哪些文件不该提交。

　　3、把Qt Creator生成的个人配置加入忽略规则

　　Qt Creator会在工程目录生成用户级配置文件，例如以.pro.user结尾或CMakeLists.txt.user这类文件，这些文件与个人环境相关，不适合共享，直接写进.gitignore能避免仓库长期脏状态。

　　4、把构建产物与中间文件按构建系统分组忽略

　　qmake会生成Makefile与临时目标文件，CMake会生成CMakeCache与CMakeFiles目录，统一忽略后能保证git status只反映真实源码改动，减少误提交与冲突排查成本。

　　5、把版本标记放到Git标签而不是靠文件名猜

　　每次可发布的节点打一个Git tag，例如v1.4.2，并在仓库里留一份简短变更记录，后续定位问题时能直接按标签回到对应源码快照，不需要靠压缩包命名去推测。

　　二、Qt与Git工作流怎么配合

　　Qt Creator对Git的集成更适合做日常提交、拉取、推送与差异查看，分支与评审节奏则要靠团队约定。你把Qt Creator里的Git命令行入口配置好，平时尽量在IDE里完成提交与冲突查看，会更顺手。

　　1、先在Qt Creator里配置Git命令行与环境变量

　　Qt Creator通过调用Git命令行客户端工作，你可以把git加入系统PATH，或在偏好设置里手动指定git可执行文件路径。

　　2、Windows场景把HOME变量设置好避免SSH钥匙找不到

　　在Qt Creator里进入【偏好设置】→【版本控制】→【Git】，勾选【Set HOME environment variable】，让Git在Qt Creator内运行时也能按常规方式找到SSH密钥与配置。

　　3、用Qt Creator的提交视图做小步提交

　　在Qt Creator顶部菜单点击【工具】→【Git】→【本地仓库】→【提交】，按文件或按块暂存后再提交，提交信息写清改动范围与原因，便于代码评审与回滚定位。

　　4、推送与拉取走远程仓库菜单统一动作入口

　　需要推送时点击【工具】→【Git】→【远程仓库】→【Push】，需要拉取时点击【工具】→【Git】→【远程仓库】→【Pull】，首次推送如果没有上游分支，Qt Creator会提示你设置upstream。

　　5、远程地址与多仓库切换用Manage Remotes集中管理

　　当你同时维护GitHub与GitLab或多个origin时，在Qt Creator点击【工具】→【Git】→【远程仓库】→【Manage Remotes】统一修改URL与别名，避免在命令行里改错远程导致推送到错误仓库。

　　6、分支节奏建议用主分支加功能分支的简单模型

　　主分支只接收已评审的合并请求，日常开发从主分支拉feature分支做小步提交，完成后合并回主分支并删除feature分支，紧急修复走hotfix分支并快速回合主分支，这套节奏对多数Qt桌面与嵌入式应用都够用。

　　三、Qt版本号与发布归档

　　版本号与发布归档要做到两件事：源码里能看出当前版本口径，仓库里能一键定位到每次发布的源码状态，并且发布产物与仓库内容分离。

　　1、把应用版本号写进构建配置并统一来源

　　qmake工程可以在pro文件里维护VERSION字段，CMake工程可以在project里维护版本号，团队约定版本号只改一个入口，避免有人只改About对话框文字却忘了改包版本。

　　2、用Git tag对应版本号并在CI里绑定产物

　　当你打tag后，让CI按tag构建并产出安装包与校验文件，安装包放到发布页或制品库，仓库只保留源码与可复现脚本，这样发布与回滚都能对齐到同一份源码快照。

　　3、构建目录在Qt Creator里固定到仓库外防止误提交

　　在Qt Creator的【项目】模式里进入构建设置，把Build directory改到仓库外固定位置，必要时关闭自动创建构建目录的选项，避免输入路径时生成一堆无用目录。

　　4、发布前做一次仓库清洁度检查作为门槛

　　发布分支或tag前确保git status无未跟踪的构建产物与user文件，确保.gitignore覆盖了团队常见的Qt Creator与构建系统生成物，这一步能显著减少发布后才发现仓库污染的情况。

　　总结

　　Qt项目要把版本管理做好，关键是先把仓库边界与忽略规则定死，再用Qt Creator把Git入口配置好，让提交、拉取、推送都走统一菜单路径，最后用版本号加Git标签把发布节点固定住。这样仓库干净、分支节奏清晰、每次发布可追溯，团队协作会稳定很多。