Windows本地Git版本管理的基本流程
更新時間：2026年05月28日 09:13:39 作者：Wils0nEdwards
本描述介紹了Windows本地Git版本管理的基本流程,包括創(chuàng)建倉庫、提交版本、創(chuàng)建分支等操作；并強調了適合新手的工作流；提建議了AI編程Agent如何輔助Git管理；并給出了實際操作建議和長期規(guī)則；最后總結了在Windows上環(huán)境下使用不使用GitHub也能實現本地Git管理
一、Windows 本地 Git 版本管理的基本流程
假設你的項目目錄是：
D:\Projects\OA_backend
你可以在 VS Code 或 IntelliJ IDEA 的終端中進入該目錄：
cd D:\Projects\OA_backend
然后執(zhí)行：
git init
這一步會在當前項目目錄下創(chuàng)建隱藏文件夾：
.git
只要有 .git 文件夾，這個項目就已經成為一個本地 Git 倉庫。
1. 查看當前項目狀態(tài)
git status
它會告訴你：
哪些文件是新建的 哪些文件被修改了 哪些文件已經加入暫存區(qū) 當前是否有未提交內容
這是最常用的 Git 命令之一。
2. 添加文件到暫存區(qū)
添加所有改動：
git add .
或者只添加某個文件：
git add src/main/java/com/company/xxx/UserController.java
簡單理解：
git add = 告訴 Git：這些改動我要納入下一次版本快照
3. 提交一個版本
git commit -m "初始化項目結構"
或者：
git commit -m "完成用戶登錄接口"
簡單理解：
git commit = 保存一個明確的版本節(jié)點
以后你就可以回到這個版本、比較這個版本、查看這個版本改了什么。
4. 查看提交歷史
git log
更簡潔一點：
git log --oneline
例如：
a13f2c1 完成用戶登錄接口 9b7d8a0 初始化項目結構
每一行都是一個版本。
5. 查看某個文件改了什么
git diff
這個命令會顯示當前未提交的代碼改動。
如果你想看某個文件：
git diff src/main/java/com/company/xxx/UserService.java
6. 回退未提交的修改
比如你改壞了某個文件，想恢復到最近一次提交的狀態(tài)：
git restore 文件路徑
例如：
git restore src/main/java/com/company/xxx/UserService.java
如果想恢復所有未提交修改，要非常謹慎：
git restore .
這會丟棄當前工作區(qū)的修改。
7. 創(chuàng)建分支進行新功能開發(fā)
比如你要開發(fā)登錄功能，可以創(chuàng)建一個新分支：
git checkout -b feature-login
查看當前分支：
git branch
開發(fā)完成并提交：
git add . git commit -m "完成登錄功能"
再切回主分支：
git checkout main
合并功能分支：
git merge feature-login
簡單理解：
main/master：穩(wěn)定主線 feature-login：臨時開發(fā)線
這樣即使新功能寫壞了，也不會直接污染主分支。
二、最適合新手的本地 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 → 提交一次 調整一次配置 → 提交一次
三、建議先創(chuàng)建.gitignore文件
很多文件不應該被 Git 管理，例如：
編譯產物 IDE 緩存 依賴目錄 日志文件 臨時文件
如果是 Java Spring Boot 項目，可以在項目根目錄創(chuàng)建 .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忽略規(guī)則"
四、AI 編程 Agent 如何幫你做 Git 版本管理？
像 Codex、Claude Code、Cursor Agent、Copilot Agent 這類 AI 編程助手，一般可以幫助你：
初始化 Git 倉庫 檢查當前 Git 狀態(tài) 創(chuàng)建 .gitignore 分析本次代碼改動 幫你生成 commit message 執(zhí)行 git add / git commit 創(chuàng)建分支 合并分支 查看歷史版本 回退錯誤修改
但你要注意一點：
涉及刪除、回退、強制覆蓋、reset、clean 等危險操作時，不要讓 AI 直接執(zhí)行，應該讓它先解釋風險并征求確認。
尤其是這些命令：
git reset --hard git clean -fd git checkout -- . git restore .
這些命令可能會丟失未提交代碼。
五、可以直接給 Codex 的 Prompt 模板
場景 1：讓 AI 檢查項目是否已有 Git 倉庫
你可以輸入：
請檢查當前項目目錄是否已經初始化為 Git 倉庫。請先執(zhí)行 git status 或等價命令，并告訴我當前倉庫狀態(tài)。不要修改任何文件。
AI 可能會執(zhí)行：
git status
然后告訴你是否已經是 Git 倉庫。
場景 2：讓 AI 初始化本地 Git 倉庫
請在當前項目根目錄初始化一個本地 Git 倉庫。初始化前先檢查當前目錄是否已經存在 .git 倉庫。如果不存在，再執(zhí)行 git init。然后根據當前項目類型創(chuàng)建合適的 .gitignore 文件，但不要提交代碼，先把你準備添加的 .gitignore 內容展示給我確認。
這個 prompt 比較安全，因為它要求 AI：
先檢查 再初始化 先展示 .gitignore 不要直接提交
場景 3：讓 AI 創(chuàng)建.gitignore
如果你是 Spring Boot 項目：
這是一個 Java Spring Boot 后端項目。請幫我在項目根目錄創(chuàng)建合適的 .gitignore 文件，忽略 target、IDE 配置文件、日志文件、系統(tǒng)臨時文件和環(huán)境變量文件。創(chuàng)建后請解釋每一類忽略規(guī)則的作用。
如果你是 Vue 項目：
這是一個 Vue 前端項目。請幫我創(chuàng)建合適的 .gitignore 文件，忽略 node_modules、dist、環(huán)境變量文件、IDE 配置文件和日志文件。創(chuàng)建后請解釋這些規(guī)則的作用。
如果是前后端分離項目：
這是一個前后端分離項目，后端是 Spring Boot，前端是 Vue。請在項目根目錄創(chuàng)建綜合性的 .gitignore 文件，避免提交 target、node_modules、dist、IDE 配置、日志文件和環(huán)境變量文件。不要刪除任何現有文件。
場景 4：讓 AI 幫你提交當前版本
請先執(zhí)行 git status，查看當前有哪些文件被修改、新增或刪除。然后總結本次改動內容，并建議一個合適的中文 commit message。不要直接執(zhí)行 git add 或 git commit，先等我確認。
確認后，你可以再說：
我確認，請將這些改動加入暫存區(qū)并提交，commit message 使用：完成用戶登錄功能基礎實現
這樣最安全。
場景 5：讓 AI 自動完成 add + commit
如果你已經信任當前改動，可以直接說：
請查看當前 Git 狀態(tài)，確認沒有敏感文件、依賴目錄或編譯產物被錯誤納入版本管理。然后執(zhí)行 git add . 并提交，commit message 請根據本次代碼改動自動生成，要求簡潔、中文、動賓結構。
例如它可能生成：
添加用戶登錄頁面
或者：
完善樹形目錄查詢接口
場景 6：讓 AI 每完成一個功能就自動提交
可以在一開始告訴 AI：
接下來你作為我的 AI 編程助手，在每完成一個相對獨立的小功能后，請先執(zhí)行 git status，總結本次改動，并建議是否進行一次 git commit。除非我明確確認，否則不要自動提交。commit message 使用中文，格式為“動詞 + 功能點”，例如“添加用戶登錄接口”“修復目錄樹渲染問題”。
這個 prompt 很適合長期項目開發(fā)。
場景 7：讓 AI 創(chuàng)建功能分支
比如你要開發(fā)登錄模塊：
請基于當前主分支創(chuàng)建一個新分支 feature-login，用于開發(fā)登錄功能。創(chuàng)建前請先檢查當前是否有未提交修改。如果有未提交修改，請先提醒我，不要直接切換分支。
如果是目錄管理功能：
請創(chuàng)建一個新分支 feature-tree-management，用于開發(fā)樹形目錄管理功能。創(chuàng)建前請檢查當前 Git 工作區(qū)是否干凈。
場景 8：讓 AI 對比本次代碼改動
請執(zhí)行 git diff，幫我審查當前未提交的代碼改動。請重點檢查：是否有明顯 bug、是否誤提交了配置文件或敏感信息、是否有不應該進入版本庫的文件。不要修改代碼，只做分析。
這個很有用，尤其適合提交前檢查。
場景 9：讓 AI 幫你生成規(guī)范 commit message
請根據當前 git diff 內容，幫我生成 3 個中文 commit message 候選，要求簡潔、準確、動賓結構，不超過 20 個字。
例如：
添加用戶登錄接口 完善目錄樹查詢邏輯 修復文件上傳路徑錯誤
場景 10：讓 AI 回退錯誤改動，但先不要執(zhí)行
我剛才的修改可能有問題。請先查看 git status 和 git diff，告訴我哪些文件被修改了，并說明如果要回退這些未提交修改，應該執(zhí)行哪些命令。不要直接執(zhí)行任何回退、刪除或 reset 操作。
這個非常重要?；赝祟惒僮饕欢ㄒ斏?。
六、推薦你給 AI Agent 的長期規(guī)則
你可以把下面這段作為項目開發(fā)初始 prompt 發(fā)給 Codex：
你是我的 AI 編程助手，請在本項目中遵守以下 Git 版本管理規(guī)則： 1. 在修改代碼前，先執(zhí)行 git status，了解當前工作區(qū)狀態(tài)。 2. 不要隨意執(zhí)行 git reset --hard、git clean -fd、git restore . 等可能丟失代碼的命令。 3. 如果需要執(zhí)行危險 Git 操作，必須先解釋風險并等待我確認。 4. 每完成一個獨立功能或 bug 修復后，請總結本次改動，并建議一個中文 commit message。 5. 除非我明確要求，否則不要自動提交代碼。 6. 提交前請檢查是否誤加入了 node_modules、target、dist、.env、日志文件或 IDE 緩存文件。 7. commit message 使用中文，格式盡量為“動詞 + 功能點”，例如“添加用戶登錄接口”“修復文件上傳異?！?。 8. 如果當前項目尚未初始化 Git 倉庫，請?zhí)嵝盐沂欠裥枰獔?zhí)行 git init，而不是直接初始化。
這段非常適合你目前這種“AI 輔助開發(fā) + 本地 Git 管理”的場景。
七、一個實際推薦流程
比如你正在開發(fā)一個 Spring Boot + Vue 項目，可以這樣操作：
第一次建立版本庫
git init
創(chuàng)建 .gitignore 后：
git add . git commit -m "初始化項目結構"
開發(fā)一個新功能前
git status
確認工作區(qū)干凈后，創(chuàng)建分支：
git checkout -b feature-login
開發(fā)過程中
讓 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 = 幫你寫代碼、分析改動、執(zhí)行 Git 命令的助手
在 Windows 上，即使完全不使用 GitHub，也可以通過 Git 實現：
本地版本保存 代碼修改記錄 錯誤回退 分支開發(fā) 功能合并 提交歷史查看
對于 AI 輔助編程，我建議你的核心原則是：
讓 AI 寫代碼可以積極一點； 讓 AI 執(zhí)行 Git 刪除、回退、重置操作一定要保守一點。
你可以先從這個 prompt 開始用：
請先檢查當前項目的 Git 狀態(tài)，告訴我是否已經初始化 Git 倉庫。如果已經初始化，請總結當前工作區(qū)是否有未提交修改；如果還沒有初始化，請告訴我下一步應該如何安全地初始化本地 Git 倉庫。不要修改任何文件。
以上就是Windows本地Git版本管理的基本流程的詳細內容，更多關于Windows本地Git版本管理的資料請關注腳本之家其它相關文章！
相關文章
文章介紹了如何將GitHub倉庫遷移至自己的GitLab服務器,首先,復制GitHub倉庫的地址并克隆到本地,然后,添加遠程GitLab倉庫,并將本地倉庫推送到GitLab,如果原倉庫使用了GitLFS,還需要額外遷移LFS對象2025-12-12
VSCODE內使用Jupyter模式運行backtrader不展示圖片、圖片尺寸無法自定義的解決方案
VSCODE中使用Jupyter模式運行backtrader時,圖片無法展示或調整尺寸,通過修改matplotlib的全局設置,并將配置文件傳遞給cerebro.plot,可以解決圖片展示和尺寸調整的問題,感興趣的朋友一起看看吧2025-02-02
這篇文章主要介紹了git詳細安裝教程及下載太慢的解決辦法，本文通過圖文并茂的形式給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-08-08
這篇文章主要介紹了單點登錄之cas集成sonar的相關知識，本文通過示例代碼給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2022-03-03
這篇文章主要介紹了Mac M1安裝Homebrew的方法步驟，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2021-03-03
文章介紹了如何通過命令行使用Git回滾到特定版本的詳細步驟,包括查看提交記錄、定位到特定的commit ID、使用git reset回滾本地文件,并最終強制提交到遠程分支2025-12-12
這篇文章主要介紹了CAPL?腳本對.ini?配置文件的高階操作,本節(jié)就針對這種情況對INI文件的讀寫方式進行升級，以達到快速便捷讀寫多鍵值對的情況，對CAPL?腳本.ini?配置文件操作感興趣的朋友一起看看吧2022-05-05
這篇文章主要為大家介紹了MybatisPlus二級緩存體系探究分析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步早日升職加薪2022-04-04
這篇文章介紹了在Visual?Studio?2019中使用Git的方法，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2022-06-06
這篇文章主要為大家介紹了Alfred?+?Gitee搭建免費圖床的使用實例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2023-01-01