Windows本地Git版本管理的基本流程

目录

• 一、Windows 本地 Git 版本管理的基本流程
• 1. 查看当前项目状态
• 2. 添加文件到暂存区
• 3. 提交一个版本
• 4. 查看提交历史
• 5. 查看某个文件改了什么
• 6. 回退未提交的修改
• 7. 创建分支进行新功能开发
• 二、最适合新手的本地 Git 工作流
• 三、建议先创建.gitignore文件
• 四、AI 编程 Agent 如何帮你做 Git 版本管理？
• 五、可以直接给 Codex 的 Prompt 模板
• 场景 1：让 AI 检查项目是否已有 Git 仓库
• 场景 2：让 AI 初始化本地 Git 仓库
• 场景 3：让 AI 创建.gitignore
• 场景 4：让 AI 帮你提交当前版本
• 场景 5：让 AI 自动完成 add + commit
• 场景 6：让 AI 每完成一个功能就自动提交
• 场景 7：让 AI 创建功能分支
• 场景 8：让 AI 对比本次代码改动
• 场景 9：让 AI 帮你生成规范 commit message
• 场景 10：让 AI 回退错误改动，但先不要执行
• 六、推荐你给 AI Agent 的长期规则
• 七、一个实际推荐流程
• 第一次建立版本库
• 开发一个新功能前
• 开发过程中
• 功能完成后合并到主分支
• 八、对你最实用的一套命令
• 九、结论

假设你的项目目录是：

D:ProjectsOA_backend

你可以在 VS Code 或 IntelliJ IDEA 的终端中进入该目录：

cd D:ProjectsOA_backend

然后执行：

git init

这一步会在当前项目目录下创建隐藏文件夹：

.git

只要有 .git 文件夹，这个项目就已经成为一个本地 Git 仓库。

git status

它会告诉你：

哪些文件是新建的
哪些文件被修改了
哪些文件已经加入暂存区
当前是否有未提交内容

这是最常用的 Git 命令之一。

添加所有改动：

git add .

或者只添加某个文件：

git add src/main/java/com/company/xxx/UserController.java

简单理解：

git add = 告诉 Git：这些改动我要纳入下一次版本快照

git commit -m "初始化项目结构"

或者：

git commit -m "完成用户登录接口"

简单理解：

git commit = 保存一个明确的版本节点

以后你就可以回到这个版本、比较这个版本、查看这个版本改了什么。

git log

更简洁一点：

git log --oneline

例如：

a13f2c1 完成用户登录接口
9b7d8a0 初始化项目结构

每一行都是一个版本。

git diff

这个命令会显示当前未提交的代码改动。

如果你想看某个文件：

git diff src/main/java/com/company/xxx/UserService.java

比如你改坏了某个文件，想恢复到最近一次提交的状态：

git restore 文件路径

例如：

git restore src/main/java/com/company/xxx/UserService.java

如果想恢复所有未提交修改，要非常谨慎：

git restore .

这会丢弃当前工作区的修改。

比如你要开发登录功能，可以创建一个新分支：

git checkout -b feature-login

查看当前分支：

git branch

开发完成并提交：

git add .
git commit -m "完成登录功能"

再切回主分支：

git checkout main

合并功能分支：

git merge feature-login

简单理解：

main/master：稳定主线
feature-login：临时开发线

这样即使新功能写坏了，也不会直接污染主分支。

你可以先不用复杂分支，只采用这个流程：

git status
git add .
git commit -m "本次修改说明"

每完成一个相对完整的小功能，就提交一次。

例如：

git add .
git commit -m "添加用户实体类和用户表Mapper"

git add .
git commit -m "完成登录页面基础布局"

git add .
git commit -m "修复后端跨域配置问题"

不要等整个项目做完才提交。比较好的习惯是：

完成一个小功能 → 提交一次
修复一个 bug → 提交一次
调整一次配置 → 提交一次

很多文件不应该被 Git 管理，例如：

编译产物
IDE 缓存
依赖目录
日志文件
临时文件

如果是 Java Spring Boot 项目，可以在项目根目录创建 .gitignore：

target/
*.class
*.log

.idea/
*.iml

.DS_Store

.env

如果是 Vue / React 前端项目，可以写：

node_modules/
dist/
.env
.env.local

.vscode/
.idea/

*.log

如果是前后端分离项目，可以综合写：

# Java
target/
*.class
*.log

# Node
node_modules/
dist/

# IDE
.idea/
.vscode/
*.iml

# Env
.env
.env.local

# OS
.DS_Store
Thumbs.db

然后提交：

git add .gitignore
git commit -m "添加Git忽略规则"

像 Codex、Claude Code、Cursor Agent、Copilot Agent 这类 AI 编程助手，一般可以帮助你：

初始化 Git 仓库
检查当前 Git 状态
创建 .gitignore
分析本次代码改动
帮你生成 commit message
执行 git add / git commit
创建分支
合并分支
查看历史版本
回退错误修改

但你要注意一点：

涉及删除、回退、强制覆盖、reset、clean 等危险操作时，不要让 AI 直接执行，应该让它先解释风险并征求确认。

尤其是这些命令：

git reset --hard
git clean -fd
git checkout -- .
git restore .

这些命令可能会丢失未提交代码。

你可以输入：

请检查当前项目目录是否已经初始化为 Git 仓库。请先执行 git status 或等价命令，并告诉我当前仓库状态。不要修改任何文件。

AI 可能会执行：

git status

然后告诉你是否已经是 Git 仓库。

请在当前项目根目录初始化一个本地 Git 仓库。初始化前先检查当前目录是否已经存在 .git 仓库。如果不存在，再执行 git init。然后根据当前项目类型创建合适的 .gitignore 文件，但不要提交代码，先把你准备添加的 .gitignore 内容展示给我确认。

这个 prompt 比较安全，因为它要求 AI：

先检查
再初始化
先展示 .gitignore
不要直接提交

如果你是 Spring Boot 项目：

这是一个 Java Spring Boot 后端项目。请帮我在项目根目录创建合适的 .gitignore 文件，忽略 target、IDE 配置文件、日志文件、系统临时文件和环境变量文件。创建后请解释每一类忽略规则的作用。

如果你是 Vue 项目：

这是一个 Vue 前端项目。请帮我创建合适的 .gitignore 文件，忽略 node_modules、dist、环境变量文件、IDE 配置文件和日志文件。创建后请解释这些规则的作用。

如果是前后端分离项目：

这是一个前后端分离项目，后端是 Spring Boot，前端是 Vue。请在项目根目录创建综合性的 .gitignore 文件，避免提交 target、node_modules、dist、IDE 配置、日志文件和环境变量文件。不要删除任何现有文件。

请先执行 git status，查看当前有哪些文件被修改、新增或删除。然后总结本次改动内容，并建议一个合适的中文 commit message。不要直接执行 git add 或 git commit，先等我确认。

确认后，你可以再说：

我确认，请将这些改动加入暂存区并提交，commit message 使用：完成用户登录功能基础实现

这样最安全。

如果你已经信任当前改动，可以直接说：

请查看当前 Git 状态，确认没有敏感文件、依赖目录或编译产物被错误纳入版本管理。然后执行 git add . 并提交，commit message 请根据本次代码改动自动生成，要求简洁、中文、动宾结构。

例如它可能生成：

添加用户登录页面

或者：

完善树形目录查询接口

可以在一开始告诉 AI：

接下来你作为我的 AI 编程助手，在每完成一个相对独立的小功能后，请先执行 git status，总结本次改动，并建议是否进行一次 git commit。除非我明确确认，否则不要自动提交。commit message 使用中文，格式为“动词 + 功能点”，例如“添加用户登录接口”“修复目录树渲染问题”。

这个 prompt 很适合长期项目开发。

比如你要开发登录模块：

请基于当前主分支创建一个新分支 feature-login，用于开发登录功能。创建前请先检查当前是否有未提交修改。如果有未提交修改，请先提醒我，不要直接切换分支。

如果是目录管理功能：

请创建一个新分支 feature-tree-management，用于开发树形目录管理功能。创建前请检查当前 Git 工作区是否干净。

请执行 git diff，帮我审查当前未提交的代码改动。请重点检查：是否有明显 bug、是否误提交了配置文件或敏感信息、是否有不应该进入版本库的文件。不要修改代码，只做分析。

这个很有用，尤其适合提交前检查。

请根据当前 git diff 内容，帮我生成 3 个中文 commit message 候选，要求简洁、准确、动宾结构，不超过 20 个字。

例如：

添加用户登录接口
完善目录树查询逻辑
修复文件上传路径错误

我刚才的修改可能有问题。请先查看 git status 和 git diff，告诉我哪些文件被修改了，并说明如果要回退这些未提交修改，应该执行哪些命令。不要直接执行任何回退、删除或 reset 操作。

这个非常重要。回退类操作一定要谨慎。

你可以把下面这段作为项目开发初始 prompt 发给 Codex：

你是我的 AI 编程助手，请在本项目中遵守以下 Git 版本管理规则：

1. 在修改代码前，先执行 git status，了解当前工作区状态。
2. 不要随意执行 git reset --hard、git clean -fd、git restore . 等可能丢失代码的命令。
3. 如果需要执行危险 Git 操作，必须先解释风险并等待我确认。
4. 每完成一个独立功能或 bug 修复后，请总结本次改动，并建议一个中文 commit message。
5. 除非我明确要求，否则不要自动提交代码。
6. 提交前请检查是否误加入了 node_modules、target、dist、.env、日志文件或 IDE 缓存文件。
7. commit message 使用中文，格式尽量为“动词 + 功能点”，例如“添加用户登录接口”“修复文件上传异常”。
8. 如果当前项目尚未初始化 Git 仓库，请提醒我是否需要执行 git init，而不是直接初始化。

这段非常适合你目前这种“AI 辅助开发 + 本地 Git 管理”的场景。

比如你正在开发一个 Spring Boot + Vue 项目，可以这样操作：

git init

创建 .gitignore 后：

git add .
git commit -m "初始化项目结构"

git status

确认工作区干净后，创建分支：

git checkout -b feature-login

让 AI 写代码、修改代码。

完成后检查：

git status
git diff

确认没问题后：

git add .
git commit -m "添加用户登录功能"

git checkout main
git merge feature-login

你刚开始只需要记住这些：

git init
git status
git add .
git commit -m "提交说明"
git log --oneline
git diff

进阶一点再掌握：

git branch
git checkout -b 分支名
git checkout main
git merge 分支名
git restore 文件名

你可以这样理解：

Git = 本地版本管理工具
GitHub/Gitee = 远程代码托管平台
Codex/AI Agent = 帮你写代码、分析改动、执行 Git 命令的助手

在 Windows 上，即使完全不使用 GitHub，也可以通过 Git 实现：

本地版本保存
代码修改记录
错误回退
分支开发
功能合并
提交历史查看

对于 AI 辅助编程，我建议你的核心原则是：

让 AI 写代码可以积极一点；
让 AI 执行 Git 删除、回退、重置操作一定要保守一点。

你可以先从这个 prompt 开始用：

请先检查当前项目的 Git 状态，告诉我是否已经初始化 Git 仓库。如果已经初始化，请总结当前工作区是否有未提交修改；如果还没有初始化，请告诉我下一步应该如何安全地初始化本地 Git 仓库。不要修改任何文件。

以上就是Windows本地Git版本管理的基本流程的详细内容，更多关于Windows本地Git版本管理的资料请关注风君子博客其它相关文章！

您可能感兴趣的文章:

• Windows 版本Git命令行的使用详解
• Windows下Git报错：touch无法识别的原因分析与7种解决方案
• Windows系统下Git的详细安装步骤和基础设置指南
• Windows下Git Bash终端高效配置指南
• Windows环境git配置多个ssh的实现步骤