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

 更新时间:2026年05月28日 09:13:39   作者:Wils0nEdwards  
本描述介绍了Windows本地Git版本管理的基本流程,包括创建仓库、提交版本、创建分支等操作;并强调了适合新手的工作流;提建议了AI编程Agent如何辅助Git管理;并给出了实际操作建议和长期规则;最后总结了在Windows上环境下使用不使用GitHub也能实现本地Git管理

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

假设你的项目目录是:

D:\Projects\OA_backend

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

cd D:\Projects\OA_backend

然后执行:

git init

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

.git

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

1. 查看当前项目状态

git status

它会告诉你:

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

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

2. 添加文件到暂存区

添加所有改动:

git add .

或者只添加某个文件:

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

简单理解:

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

3. 提交一个版本

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

或者:

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

简单理解:

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

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

4. 查看提交历史

git log

更简洁一点:

git log --oneline

例如:

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

每一行都是一个版本。

5. 查看某个文件改了什么

git diff

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

如果你想看某个文件:

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

6. 回退未提交的修改

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

git restore 文件路径

例如:

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

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

git restore .

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

7. 创建分支进行新功能开发

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

git checkout -b feature-login

查看当前分支:

git branch

开发完成并提交:

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

再切回主分支:

git checkout main

合并功能分支:

git merge feature-login

简单理解:

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

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

二、最适合新手的本地 Git 工作流

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

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

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

例如:

git add .
git commit -m "添加用户实体类和用户表Mapper"
git add .
git commit -m "完成登录页面基础布局"
git add .
git commit -m "修复后端跨域配置问题"

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

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

三、建议先创建.gitignore文件

很多文件不应该被 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忽略规则"

四、AI 编程 Agent 如何帮你做 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 .

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

五、可以直接给 Codex 的 Prompt 模板

场景 1:让 AI 检查项目是否已有 Git 仓库

你可以输入:

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

AI 可能会执行:

git status

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

场景 2:让 AI 初始化本地 Git 仓库

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

这个 prompt 比较安全,因为它要求 AI:

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

场景 3:让 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 配置、日志文件和环境变量文件。不要删除任何现有文件。

场景 4:让 AI 帮你提交当前版本

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

确认后,你可以再说:

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

这样最安全。

场景 5:让 AI 自动完成 add + commit

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

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

例如它可能生成:

添加用户登录页面

或者:

完善树形目录查询接口

场景 6:让 AI 每完成一个功能就自动提交

可以在一开始告诉 AI:

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

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

场景 7:让 AI 创建功能分支

比如你要开发登录模块:

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

如果是目录管理功能:

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

场景 8:让 AI 对比本次代码改动

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

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

场景 9:让 AI 帮你生成规范 commit message

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

例如:

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

场景 10:让 AI 回退错误改动,但先不要执行

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

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

六、推荐你给 AI Agent 的长期规则

你可以把下面这段作为项目开发初始 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版本管理的资料请关注脚本之家其它相关文章!

相关文章

  • HTTP Referer详解及Referer控制

    HTTP Referer详解及Referer控制

    HTTP Referer是header的一部分,当浏览器向web服务器发送请求的时候,一般会带上Referer,告诉服务器我是从哪个页面链接过来的
    2018-04-04
  • 日历控件和天气使用分享

    日历控件和天气使用分享

    本文给大家分享的2个简单而且实用的小功能代码,分别是日历控件和天气预报接口,推荐给大家,需要的小伙伴快来参考下吧
    2015-03-03
  • Git 的基本操作、开发流程、实用技巧总结(陈彦贝)

    Git 的基本操作、开发流程、实用技巧总结(陈彦贝)

    这篇文章主要介绍了Git 的基本操作、开发流程、实用技巧总结,需要的朋友可以参考下
    2017-09-09
  • 清除git本地缓存和gitigore模板方式

    清除git本地缓存和gitigore模板方式

    文章主要介绍了如何清除Git本地缓存以及如何使用.gitignore文件来忽略文件,文章还提供了后端和前端的.gitignore文件模板供参考
    2026-03-03
  • Spark GraphX 分布式图处理框架图算法详解

    Spark GraphX 分布式图处理框架图算法详解

    这篇文章主要为大家介绍了Spark GraphX 分布式图处理框架图算法详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-10-10
  • 清理Git分支从查看到批量删除无效分支的全流程

    清理Git分支从查看到批量删除无效分支的全流程

    在日常开发中,我们经常会创建临时分支用于开发新功能或修复 Bug,随着时间推移,这些分支被合并、删除,但本地仓库中仍可能保留大量过期分支,这篇文章带你一步步彻底清理本地无用分支,并同步远程状态,需要的朋友可以参考下
    2025-10-10
  • Git常用场景使用方法

    Git常用场景使用方法

    这篇文章主要介绍了Git常用场景使用,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • GIT合并分支的三种实现方式

    GIT合并分支的三种实现方式

    这篇文章主要介绍了GIT合并分支的三种实现方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-03-03
  • udp协议简介_动力节点Java学院整理

    udp协议简介_动力节点Java学院整理

    这篇文章主要为大家详细介绍了udp协议简介的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-07-07
  • 分享VSCOCE远程连接服务器的一次错误记录(推荐)

    分享VSCOCE远程连接服务器的一次错误记录(推荐)

    这篇文章主要介绍了VSCOCE远程连接服务器的一次错误记录,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-04-04

最新评论