Git 完整落地方案适配你的 Qt 企业项目包含仓库初始化完整流程 团队协作规范 冲突解决 提交校验 实操案例全程可直接复制命令执行适配 Windows Git Bash。一、前置回顾快速核对基础配置1. 检查全局配置首次使用必确认打开Git Bash执行bash运行# 查看全局配置 git config --global --list若无信息执行以下配置替换为你自己的信息bash运行# 用户名团队内唯一标识 git config --global user.name 张三 # 邮箱用于提交记录、远程仓库账号关联 git config --global user.email zhangsancompany.com # Windows 换行符统一Qt/跨平台项目必配 git config --global core.autocrlf true git config --global core.safecrlf false # 可选默认编辑器为 VSCode git config --global core.editor code --wait2. 项目专属.gitignoreQt 企业项目最终版在你的QtEnterprise根目录新建.gitignore粘贴以下内容屏蔽编译产物、临时文件、本地配置gitignore# Qt 编译/构建产物 # 子项目编译目录 debug/ release/ bin/ .obj/ .moc/ .rcc/ .ui/ # Qt 本地用户配置每人本地配置不同禁止提交 *.pro.user *.pro.user.* *.autosave # 编译中间文件 moc_*.cpp ui_*.h qrc_*.cpp *.o *.obj *.pdb *.ilk # 库文件/可执行文件 # 动态库、静态库、程序本体 *.dll *.so *.dylib *.lib *.a *.exe # 项目运行生成文件 # 日志、数据库、配置文件 *.log log.txt app.log *.db app.db *.ini app.ini # IDE 工具文件 .idea/ .vscode/ *.swp *.swo .DS_Store # 脚本/临时目录 tmp/ build/ update/二、本地仓库初始化从零搭建完整仓库进入你的项目根目录示例路径D:\QtEnterprise在 Git Bash 依次执行bash运行# 1. 进入项目根目录替换为你实际路径 cd /d/D/QtEnterprise # 2. 初始化本地 Git 仓库 git init # 3. 查看文件状态此时所有文件为未跟踪状态 git status # 4. 添加所有文件到暂存区 git add . # 5. 首次提交遵循企业提交规范 git commit -m feat: 初始化企业级Qt多项目工程 - 集成UI、网络、数据库、日志模块 - 新增配置中心、权限、监控、自动更新 - 各模块独立pri管理配套打包脚本补充撤销错误操作应急bash运行# 撤销 git add . 文件回到未暂存 git reset HEAD . # 撤销最后一次 commit保留代码修改 git reset --soft HEAD~1三、关联远程仓库Gitee/GitHub/GitLab 通用主流代码托管平台操作一致分HTTPS和SSH两种方式推荐团队使用SSH免密码。方式 1HTTPS新手快速上手每次推送需输账号密码bash运行# 关联远程仓库 origin替换为你自己的远程仓库地址 git remote add origin https://gitee.com/你的账号/QtEnterprise.git # 推送到远程 master 分支-u 绑定上下游后续直接 git push git push -u origin master方式 2SSH企业团队首选免密推送 / 拉取步骤 1生成 SSH 密钥bash运行# 一路回车无需设置密码 ssh-keygen -t ed25519 -C 你的邮箱company.com步骤 2复制公钥Windows 密钥默认路径C:\Users\你的用户名\.ssh\id_ed25519.pub打开文件全选复制内容。步骤 3配置到远程平台打开 Gitee/GitHub → 个人设置 →SSH 公钥粘贴复制的公钥保存。步骤 4关联远程仓库bash运行# 移除原有HTTPS关联如有 git remote remove origin # 关联SSH地址替换为你的仓库SSH地址 git remote add origin gitgitee.com:你的账号/QtEnterprise.git # 首次推送 git push -u origin master常用远程仓库命令bash运行# 查看远程仓库地址 git remote -v # 拉取远程最新代码多人协作必用 git pull origin master四、企业级分支规范团队协作标准采用Git Flow 经典分支模型适配中大型项目开发分工明确、版本稳定。1. 分支角色说明固定命名全团队统一表格分支名作用权限master生产环境正式版本永远只合并不直接修改管理员develop开发主分支存放已完成的功能所有功能分支合并到此全体开发feature/*功能分支单人开发新功能例feature/ui-component个人开发fix/*缺陷修复分支修复线上 / 测试 BUG例fix/login-error全体开发release/*版本发布分支测试、预上线例release/v1.0.0测试 / 运维2. 完整分支流转流程实操命令场景 1开发新功能标准流程bash运行# 1. 拉取 develop 最新代码保证本地代码最新 git checkout develop git pull origin develop # 2. 基于develop创建功能分支命名规范feature/功能名 git checkout -b feature/config-center # 3. 本地开发、修改代码... # 4. 开发完成提交代码 git add . git commit -m feat: 完善配置中心读写逻辑 # 5. 推送到远程功能分支 git push origin feature/config-center # 6. 提 Merge Request(MR)/Pull Request(PR)合并到 develop平台操作场景 2修复 BUGbash运行# 切换到develop拉取最新代码 git checkout develop git pull origin develop # 创建修复分支 git checkout -b fix/db-connect # 修复代码后提交 git add . git commit -m fix: 修复SQLite数据库初始化失败问题 git push origin fix/db-connect # 平台提交MR合并到develop场景 3版本发布上线bash运行# 基于develop创建发布分支 git checkout develop git pull origin develop git checkout -b release/v1.0.0 # 测试、修复小问题提交代码 git commit -m chore: 版本预发布v1.0.0 git push origin release/v1.0.0 # 测试通过后合并 release 到 master 和 develop git checkout master git merge release/v1.0.0 git push origin master git checkout develop git merge release/v1.0.0 git push origin develop # 上线完成删除临时发布分支 git branch -d release/v1.0.0 git push origin --delete release/v1.0.0五、代码冲突解决方案高频问题多人同时修改同一文件git pull/ 合并分支时会出现代码冲突分两种场景处理。1. 冲突标识说明文件内标记打开冲突文件会看到 Git 自动标记的内容plaintext HEAD 本地当前代码 本地修改的代码 远程/分支合并过来的代码 分支名 外来代码操作规则分析两边代码逻辑保留需要的内容删除冲突标记保存文件完成冲突修复。2. 场景 1拉取远程代码产生冲突bash运行# 1. 拉取代码提示冲突 git pull origin develop # 2. 查看冲突文件红色标注 git status # 3. 打开冲突文件手动修复冲突保存 # 4. 修复后提交 git add . git commit -m merge: 解决代码拉取冲突 # 5. 推送 git push origin develop3. 场景 2合并分支产生冲突bash运行# 1. 合并分支触发冲突 git merge feature/config-center # 2. 查看冲突文件、手动修复 # 3. 完成合并提交 git add . git commit -m merge: 合并配置中心功能分支解决冲突应急回退冲突无法解决时bash运行# 终止本次合并回到合并前状态 git merge --abort六、企业级提交规范 提交校验约束团队代码风格1. 统一提交注释格式全团队强制执行格式类型(作用域): 描述表格类型含义示例feat新增功能feat: 新增自动更新模块fix修复 BUGfix: 修复网络请求超时问题refactor代码重构无功能变化refactor: 重构日志模块代码结构style代码格式调整空格 / 缩进style: 统一代码缩进格式docs文档 / 注释修改docs: 补充数据库模块注释chore构建 / 脚本 / 配置修改chore: 更新打包脚本2. 本地提交校验简单拦截不规范提交利用 Git钩子 (Hook)实现提交代码时自动检查注释格式。进入项目目录下的隐藏文件夹.git/hooks新建文件commit-msg无后缀粘贴以下脚本Windows Git Bash 可用sh#!/bin/sh # 获取本次提交的注释 COMMIT_MSG$(cat $1) # 正则校验提交格式feat/fix/refactor/style/docs/chore: 内容 REGEX^(feat|fix|refactor|style|docs|chore): .{1,} if ! echo $COMMIT_MSG | grep -qE $REGEX; then echo echo ❌ 提交失败注释格式不规范 echo ✅ 标准格式类型: 描述 echo ✅ 合法类型feat/fix/refactor/style/docs/chore echo ✅ 示例feat: 新增UI组件库 echo exit 1 fi exit 0赋予执行权限Git Bash 执行bash运行chmod x .git/hooks/commit-msg测试写不规范注释会直接拦截提交强制团队遵守规范。进阶团队规模大可搭配commitlint husky实现更强校验本脚本满足中小企业日常使用。七、高频实用命令清单日常开发速查1. 状态 日志bash运行git status # 查看文件状态 git log # 查看提交历史 git log --oneline # 简洁版提交日志推荐2. 撤销 回退bash运行# 丢弃工作区文件修改未add git checkout -- 文件名 # 撤销暂存区已add未commit git reset HEAD 文件名 # 回退到指定版本彻底回退代码谨慎使用 git reset --hard 提交ID3. 分支操作bash运行git branch # 查看本地分支 git branch -a # 查看所有分支本地远程 git checkout 分支名 # 切换分支 git branch -d 分支名 # 删除本地分支 git push origin --delete 分支名 # 删除远程分支4. 克隆已有项目新成员入职bash运行# HTTPS 克隆 git clone https://gitee.com/账号/QtEnterprise.git # SSH 克隆推荐 git clone gitgitee.com:账号/QtEnterprise.git八、Qt 项目 Git 专属注意事项避坑严禁提交*.pro.user、编译目录、dll/exe.gitignore已屏蔽无需手动处理跨平台换行符已配置core.autocrlftrueWindows/Linux 协作不会出现换行冲突大文件处理图片、安装包等大文件不要直接提交到 Git使用网盘 / 文件服务器托管定期拉取多人协作时开发前先执行 git pull避免大面积冲突禁止直接修改 master所有开发必须走功能分支保护线上版本。九、完整工作流总结单人 / 团队每日流程单人开发流程bash运行git pull # 拉取最新代码 # 编写代码... git add . git commit -m feat: xxx git push团队多人开发流程标准bash运行git checkout develop git pull origin develop # 同步开发分支最新代码 git checkout feature/xxx # 切换个人功能分支 # 编写代码... git add . git commit -m feat: xxx git push origin feature/xxx # 推送到远程功能分支 # 平台提交MR合并到develop
Git 完整落地方案（适配你的 Qt 企业项目）
发布时间：2026/5/31 6:52:47
Git 完整落地方案适配你的 Qt 企业项目包含仓库初始化完整流程 团队协作规范 冲突解决 提交校验 实操案例全程可直接复制命令执行适配 Windows Git Bash。一、前置回顾快速核对基础配置1. 检查全局配置首次使用必确认打开Git Bash执行bash运行# 查看全局配置 git config --global --list若无信息执行以下配置替换为你自己的信息bash运行# 用户名团队内唯一标识 git config --global user.name 张三 # 邮箱用于提交记录、远程仓库账号关联 git config --global user.email zhangsancompany.com # Windows 换行符统一Qt/跨平台项目必配 git config --global core.autocrlf true git config --global core.safecrlf false # 可选默认编辑器为 VSCode git config --global core.editor code --wait2. 项目专属.gitignoreQt 企业项目最终版在你的QtEnterprise根目录新建.gitignore粘贴以下内容屏蔽编译产物、临时文件、本地配置gitignore# Qt 编译/构建产物 # 子项目编译目录 debug/ release/ bin/ .obj/ .moc/ .rcc/ .ui/ # Qt 本地用户配置每人本地配置不同禁止提交 *.pro.user *.pro.user.* *.autosave # 编译中间文件 moc_*.cpp ui_*.h qrc_*.cpp *.o *.obj *.pdb *.ilk # 库文件/可执行文件 # 动态库、静态库、程序本体 *.dll *.so *.dylib *.lib *.a *.exe # 项目运行生成文件 # 日志、数据库、配置文件 *.log log.txt app.log *.db app.db *.ini app.ini # IDE 工具文件 .idea/ .vscode/ *.swp *.swo .DS_Store # 脚本/临时目录 tmp/ build/ update/二、本地仓库初始化从零搭建完整仓库进入你的项目根目录示例路径D:\QtEnterprise在 Git Bash 依次执行bash运行# 1. 进入项目根目录替换为你实际路径 cd /d/D/QtEnterprise # 2. 初始化本地 Git 仓库 git init # 3. 查看文件状态此时所有文件为未跟踪状态 git status # 4. 添加所有文件到暂存区 git add . # 5. 首次提交遵循企业提交规范 git commit -m feat: 初始化企业级Qt多项目工程 - 集成UI、网络、数据库、日志模块 - 新增配置中心、权限、监控、自动更新 - 各模块独立pri管理配套打包脚本补充撤销错误操作应急bash运行# 撤销 git add . 文件回到未暂存 git reset HEAD . # 撤销最后一次 commit保留代码修改 git reset --soft HEAD~1三、关联远程仓库Gitee/GitHub/GitLab 通用主流代码托管平台操作一致分HTTPS和SSH两种方式推荐团队使用SSH免密码。方式 1HTTPS新手快速上手每次推送需输账号密码bash运行# 关联远程仓库 origin替换为你自己的远程仓库地址 git remote add origin https://gitee.com/你的账号/QtEnterprise.git # 推送到远程 master 分支-u 绑定上下游后续直接 git push git push -u origin master方式 2SSH企业团队首选免密推送 / 拉取步骤 1生成 SSH 密钥bash运行# 一路回车无需设置密码 ssh-keygen -t ed25519 -C 你的邮箱company.com步骤 2复制公钥Windows 密钥默认路径C:\Users\你的用户名\.ssh\id_ed25519.pub打开文件全选复制内容。步骤 3配置到远程平台打开 Gitee/GitHub → 个人设置 →SSH 公钥粘贴复制的公钥保存。步骤 4关联远程仓库bash运行# 移除原有HTTPS关联如有 git remote remove origin # 关联SSH地址替换为你的仓库SSH地址 git remote add origin gitgitee.com:你的账号/QtEnterprise.git # 首次推送 git push -u origin master常用远程仓库命令bash运行# 查看远程仓库地址 git remote -v # 拉取远程最新代码多人协作必用 git pull origin master四、企业级分支规范团队协作标准采用Git Flow 经典分支模型适配中大型项目开发分工明确、版本稳定。1. 分支角色说明固定命名全团队统一表格分支名作用权限master生产环境正式版本永远只合并不直接修改管理员develop开发主分支存放已完成的功能所有功能分支合并到此全体开发feature/*功能分支单人开发新功能例feature/ui-component个人开发fix/*缺陷修复分支修复线上 / 测试 BUG例fix/login-error全体开发release/*版本发布分支测试、预上线例release/v1.0.0测试 / 运维2. 完整分支流转流程实操命令场景 1开发新功能标准流程bash运行# 1. 拉取 develop 最新代码保证本地代码最新 git checkout develop git pull origin develop # 2. 基于develop创建功能分支命名规范feature/功能名 git checkout -b feature/config-center # 3. 本地开发、修改代码... # 4. 开发完成提交代码 git add . git commit -m feat: 完善配置中心读写逻辑 # 5. 推送到远程功能分支 git push origin feature/config-center # 6. 提 Merge Request(MR)/Pull Request(PR)合并到 develop平台操作场景 2修复 BUGbash运行# 切换到develop拉取最新代码 git checkout develop git pull origin develop # 创建修复分支 git checkout -b fix/db-connect # 修复代码后提交 git add . git commit -m fix: 修复SQLite数据库初始化失败问题 git push origin fix/db-connect # 平台提交MR合并到develop场景 3版本发布上线bash运行# 基于develop创建发布分支 git checkout develop git pull origin develop git checkout -b release/v1.0.0 # 测试、修复小问题提交代码 git commit -m chore: 版本预发布v1.0.0 git push origin release/v1.0.0 # 测试通过后合并 release 到 master 和 develop git checkout master git merge release/v1.0.0 git push origin master git checkout develop git merge release/v1.0.0 git push origin develop # 上线完成删除临时发布分支 git branch -d release/v1.0.0 git push origin --delete release/v1.0.0五、代码冲突解决方案高频问题多人同时修改同一文件git pull/ 合并分支时会出现代码冲突分两种场景处理。1. 冲突标识说明文件内标记打开冲突文件会看到 Git 自动标记的内容plaintext HEAD 本地当前代码 本地修改的代码 远程/分支合并过来的代码 分支名 外来代码操作规则分析两边代码逻辑保留需要的内容删除冲突标记保存文件完成冲突修复。2. 场景 1拉取远程代码产生冲突bash运行# 1. 拉取代码提示冲突 git pull origin develop # 2. 查看冲突文件红色标注 git status # 3. 打开冲突文件手动修复冲突保存 # 4. 修复后提交 git add . git commit -m merge: 解决代码拉取冲突 # 5. 推送 git push origin develop3. 场景 2合并分支产生冲突bash运行# 1. 合并分支触发冲突 git merge feature/config-center # 2. 查看冲突文件、手动修复 # 3. 完成合并提交 git add . git commit -m merge: 合并配置中心功能分支解决冲突应急回退冲突无法解决时bash运行# 终止本次合并回到合并前状态 git merge --abort六、企业级提交规范 提交校验约束团队代码风格1. 统一提交注释格式全团队强制执行格式类型(作用域): 描述表格类型含义示例feat新增功能feat: 新增自动更新模块fix修复 BUGfix: 修复网络请求超时问题refactor代码重构无功能变化refactor: 重构日志模块代码结构style代码格式调整空格 / 缩进style: 统一代码缩进格式docs文档 / 注释修改docs: 补充数据库模块注释chore构建 / 脚本 / 配置修改chore: 更新打包脚本2. 本地提交校验简单拦截不规范提交利用 Git钩子 (Hook)实现提交代码时自动检查注释格式。进入项目目录下的隐藏文件夹.git/hooks新建文件commit-msg无后缀粘贴以下脚本Windows Git Bash 可用sh#!/bin/sh # 获取本次提交的注释 COMMIT_MSG$(cat $1) # 正则校验提交格式feat/fix/refactor/style/docs/chore: 内容 REGEX^(feat|fix|refactor|style|docs|chore): .{1,} if ! echo $COMMIT_MSG | grep -qE $REGEX; then echo echo ❌ 提交失败注释格式不规范 echo ✅ 标准格式类型: 描述 echo ✅ 合法类型feat/fix/refactor/style/docs/chore echo ✅ 示例feat: 新增UI组件库 echo exit 1 fi exit 0赋予执行权限Git Bash 执行bash运行chmod x .git/hooks/commit-msg测试写不规范注释会直接拦截提交强制团队遵守规范。进阶团队规模大可搭配commitlint husky实现更强校验本脚本满足中小企业日常使用。七、高频实用命令清单日常开发速查1. 状态 日志bash运行git status # 查看文件状态 git log # 查看提交历史 git log --oneline # 简洁版提交日志推荐2. 撤销 回退bash运行# 丢弃工作区文件修改未add git checkout -- 文件名 # 撤销暂存区已add未commit git reset HEAD 文件名 # 回退到指定版本彻底回退代码谨慎使用 git reset --hard 提交ID3. 分支操作bash运行git branch # 查看本地分支 git branch -a # 查看所有分支本地远程 git checkout 分支名 # 切换分支 git branch -d 分支名 # 删除本地分支 git push origin --delete 分支名 # 删除远程分支4. 克隆已有项目新成员入职bash运行# HTTPS 克隆 git clone https://gitee.com/账号/QtEnterprise.git # SSH 克隆推荐 git clone gitgitee.com:账号/QtEnterprise.git八、Qt 项目 Git 专属注意事项避坑严禁提交*.pro.user、编译目录、dll/exe.gitignore已屏蔽无需手动处理跨平台换行符已配置core.autocrlftrueWindows/Linux 协作不会出现换行冲突大文件处理图片、安装包等大文件不要直接提交到 Git使用网盘 / 文件服务器托管定期拉取多人协作时开发前先执行 git pull避免大面积冲突禁止直接修改 master所有开发必须走功能分支保护线上版本。九、完整工作流总结单人 / 团队每日流程单人开发流程bash运行git pull # 拉取最新代码 # 编写代码... git add . git commit -m feat: xxx git push团队多人开发流程标准bash运行git checkout develop git pull origin develop # 同步开发分支最新代码 git checkout feature/xxx # 切换个人功能分支 # 编写代码... git add . git commit -m feat: xxx git push origin feature/xxx # 推送到远程功能分支 # 平台提交MR合并到develop
