Git 本地版本控制极简使用笔记（Qt 项目专用）

核心原则全程仅需掌握5 个核心命令满足日常开发、版本记录、回滚修复的全部需求无需复杂操作适配传感器环筛管理平台项目一、基础准备已完成备查1. 仓库初始化仅执行 1 次# 进入项目根目录Windows系统必加/d否则无法切换盘符 cd /d F:\workProject\XXXXXXXXXXXX0707Qt5_6 # 初始化本地Git仓库 git init✅ 成功标志终端提示Initialized empty Git repository in 项目路径/.git/2. .gitignore 配置已完成核心作用过滤无用文件项目根目录的.gitignore已配置 Qt 专属规则自动过滤编译产物、配置文件、打包文件避免仓库臃肿无需手动修改。二、日常开发核心流程99% 场景用这 3 步步骤 1修改代码后查看修改状态可选推荐git status✅ 作用清晰看到哪些文件被修改 / 新增 / 删除确认需要提交的内容避免漏提 / 错提。❌ 红色标识未加入暂存区的修改文件✅ 绿色标识已加入暂存区的修改文件。步骤 2将所有修改加入暂存区必执行git add . 关键结尾的英文点号不能漏代表「当前目录下所有修改文件」一键全部加入暂存区无需单个选择文件。步骤 3提交修改生成新版本必执行核心步骤git commit -m 备注内容✅ 备注编写规则核心人话描述一眼看懂格式要求动作 具体内容动宾结构简洁明了控制在一行推荐动作修复 / 新增 / 优化 / 删除 / 更新 / 迭代项目适配示例git commit -m 修复工具栏窗口拖动问题移除事件过滤器 git commit -m 新增XX温度实时监控显示功能 git commit -m 优化传感器数据解析逻辑提升实时性 git commit -m 迭代项目至V2.01修复3个已知bug git commit -m 更新.gitignore过滤exeRealse打包文件夹✅ 提交成功标志终端显示X files changed, X insertions(), X deletions(-)并自动生成唯一哈希版本号如3ccd76a。三、版本管理常用操作查历史 / 回滚必备1. 查看所有历史版本最常用查版本号 / 备注git log作用列出所有提交记录包含版本号前 6 位即可使用、提交时间、提交备注✅ 操作技巧按Enter键翻页按q键退出查看✅ 核心提取每个提交最上方的commit 3ccd76a...前 6 位3ccd76a就是该版本的唯一标识2. 回滚到指定版本改崩代码时救命用慎用方式 1快速回滚到上一个版本git reset --hard HEAD^方式 2回滚到任意历史版本推荐精准定位# 通用格式git reset --hard 版本号前6位 git reset --hard 3ccd76a⚠️重要提醒回滚操作执行后当前所有未提交的修改会被彻底删除且无法恢复✅ 回滚前必做先执行git status确认是否有未提交修改若有需先提交或手动备份。四、高频小命令备查解决局部 / 整体修改问题1. 放弃未加入暂存区的修改单个文件# 通用格式git checkout -- 文件名含相对路径若文件在子目录 git checkout -- mainwindow.cpp git checkout -- src/sensor.cpp✅ 作用把单个文件恢复到最近一次提交的状态适合单个文件改崩时快速还原不影响其他文件。2. 放弃所有未提交的修改整个项目git checkout .✅ 作用一键还原整个项目到最近一次提交的状态适合多处文件改崩且无需保留当前修改时。五、避坑指南核心注意杜绝版本控制翻车1. 绝对不能删除的文件项目根目录的.git文件夹隐藏文件夹是 Git 仓库的核心文件删除后所有历史版本记录会永久丢失无法恢复2. 无需手动处理的未提交文件.gitignore已自动过滤以下文件无需手动选择排除Git 会自动忽略编译产物build/、debug/、release/、*.exe、*.dll、*.libQt 专属配置*.pro.user、*.pro.user.*、*.autosave项目打包文件envRealse/系统 / IDE 配置Thumbs.db、.vscode/、.idea/、*.suo。3. 提交备注避坑❌ 禁止无意义备注如修改代码、更新、bug修复无法定位具体修改内容❌ 禁止写入 Git 自动版本号如3ccd76a版本更新Git 会自动管理版本号多此一举✅ 必须写具体内容如修复工具栏mousePress事件过滤导致的窗口任意位置移动问题。4. 回滚操作避坑回滚前务必反复确认当前修改是否无需保留避免误删重要开发代码若需频繁回滚建议回滚前记录最新版本号防止回滚后无法恢复到最新状态。命令核心作用适用场景cd /d 项目完整路径进入项目根目录所有 Git 操作前的基础步骤git status查看文件修改状态红 / 绿标识提交前确认修改内容避免漏提git add .将所有修改加入暂存区提交前必执行步骤git commit -m 备注提交修改生成新的版本记录日常开发核心步骤完成功能 / 修复 bug 后执行git log查看所有历史版本提取版本号回滚版本前查询对应版本号git reset --hard 版本号回滚到指定历史版本代码改崩、功能实现失败时还原git checkout -- 文件名放弃单个文件未提交的修改单个文件改崩需快速还原时git checkout .放弃所有文件未提交的修改多个文件改崩无需保留当前修改时七、日常使用流程示例贴合传感器环筛管理平台项目场景 1修复工具栏窗口移动问题后保存新版本打开终端进入项目目录cd /d F:\workProject\XXXXXXXXXXXXXX0707Qt5_6查看修改文件git status确认mainwindow.cpp、toolbar.cpp为红色修改状态将修改加入暂存区git add .此时修改文件变为绿色提交并生成版本git commit -m 修复工具栏事件过滤器禁用窗口任意位置移动功能确认提交结果git log查看提交记录确认版本生成成功记录版本号备用日常最舒服的工作流推荐开 Qt Creator → 写代码改完一段功能打开 cmd → 进入项目执行git add . git commit -m 修复窗口拖动问题回到 Qt 继续写代码循环……场景 2改崩传感器数据解析代码回滚到上一可用版本打开终端进入项目目录cd /d F:\workProject\XXXXXXXXXXXXXX0707Qt5_6查看历史版本git log找到上一可用版本的版本号如8f2e3d执行回滚操作git reset --hard 8f2e3d验证结果打开 Qt 项目确认代码已恢复到上一可用版本可正常编译运行。回滚代码关闭 Qt → 执行回滚 → 再打开 Qt防止回滚的时候回复头文件和源文件和目前编辑的产生冲突。场景三增加大节点备份。增加git add . git commit -m V2.01大版本更新 git tag V2.01 # 打标签标记大节点 # 可选复制项目文件夹做物理备份想回到大节点git checkout V2.01查看所有大节点标签git tag八、使用建议把「常用命令速查」部分复制到文本文档贴在电脑桌面开发时直接复制命令无需记忆日常开发遵循「修改代码→git status→git add .→git commit -m 备注」流程每完成一个小功能 / 修复一个 bug 就提交一次版本记录越细致后续回滚越精准纯本地开发无需学习复杂操作分支、合并、远程仓库等掌握上述命令即可满足全部版本控制需求提交备注保持统一风格便于后续自己 / 团队快速查阅历史修改记录。文章word版本。通过网盘分享的文件Git 本地版本控制极简使用笔记Qt 项目专用链接: https://pan.baidu.com/s/1_PcoeHe2OLsOZ61VgdlSHg?pwd1234 提取码: 1234