一、目的与背景
本文档介绍了如何使用 Git 作为本地版本管理工具，专门用于跟踪本地文件的改动、回滚、查看提交记录等操作。Git 仅用于本地版本管理，并未涉及任何远程仓库的创建、上传或开源。
1.1 本地 Git 只用于以下目的：
- 代码变更追踪
- 提供回滚功能
- 跟踪新旧改动，尤其在后续修复 Bug 时区分哪些是新问题，哪些是已有改动
- 转移到新电脑时保留提交记录
1.2 本地 Git 使用优势：
- 避免误改、误删： 在文件修改后能够追踪和恢复
- 固定提交点： 可以把修复固定成一个提交点
- 分前后端管理： 可以分别管理前端和后端的 Git 仓库
- 提交历史查看： 后续其他人接手时可以查看提交记录
二、Git 配置与使用
2.1 目录结构与 Git 仓库初始化
当前项目在本地初始化了两个 Git 仓库：
- 后端仓库路径：
D:\Projects\backend\.git - 前端仓库路径：
D:\Projects\frontend\.git
每个项目都拥有自己的本地 Git 仓库，未创建任何远程仓库（如 GitHub、Gitee、GitLab）。
2.2 如何验证 Git 安装
可以通过以下命令验证本机是否安装了 Git：
git --version：查看 Git 版本，输出如git version 2.53.0.windows.1表示已安装where git：查看 Git 可执行文件的位置
2.3 常用 Git 命令
- 检查当前状态：
git status：查看当前文件的修改状态git branch：查看当前分支git log --oneline -3：查看最近的 3 条提交记录git remote -v：确认是否配置了远程仓库（输出为空表示没有远程仓库）
- 提交改动：
git add .：将所有更改添加到暂存区git commit -m "提交信息"：提交更改并添加描述信息
2.4 忽略文件配置
后端和前端仓库已经配置了 .gitignore 文件，以排除常见的运行产物、敏感文件和不需要提交的文件，如：
.env.data/node_modules/target/dist/
2.5 提交前检查
在提交前，请务必检查以下内容：
- 运行
git status，确认没有不必要的文件被加入暂存区 - 检查是否有远程仓库配置：执行
git remote -v，确认没有配置远程仓库 - 确认没有提交敏感或产物文件：确保
.gitignore配置已生效，避免将敏感信息或生成的文件提交到 Git
2.6 分前后端管理
- 后端仓库当前分支：
main - 前端仓库当前分支：
codex/attachment-governance
三、Git 历史与转移
3.1 保留本地提交历史
若要将本地 Git 仓库转移到其他电脑，可以按照以下步骤操作：
- 复制项目目录，包括隐藏目录
.git：- 复制
D:\Projects\frontend\.git - 复制
D:\Projects\backend\.git
- 复制
- 在新电脑上检查 Git 状态：
- 执行
git status查看工作区状态 - 执行
git branch查看当前分支 - 执行
git log --oneline -3查看最近的提交记录 - 执行
git remote -v确认没有远程仓库配置
- 执行
3.2 仅复制代码（不保留 Git 历史）
如果不需要 Git 提交历史，可以只复制代码文件，不包括 .git 目录。这样可以在新电脑上重新初始化 Git 仓库：
- 进入项目目录：
git initgit add .git commit -m "chore: import finance web"
- 这种方式会丢失所有本地的提交历史，但能保留代码并重新开始版本管理。
四、Git 与发布
4.1 Git 仅用于本地版本管理
- Git 不是开源，不是发布工具
- 没有创建远程仓库，没有上传代码至 GitHub/Gitee/GitLab
- Git 不等于发布，不等于公开，不等于上传
4.2 使用 Git 的目的
- 版本管理： 追踪变更、查看提交历史、回滚改动
- 项目管理： 区分前后端不同阶段的修复与功能
- 便于转移： 便于将项目转移到新电脑时保留历史记录
五、总结
本地 Git 仓库为您提供了一个便捷的工具来追踪代码变更、回滚修改、查看历史记录等，但它并不等同于开源或上传。您可以根据项目需求灵活管理 Git 仓库，并随时将其转移到其他电脑，保留您所有的本地提交记录。
六、交给AI可以提示
- 不要求开源，不要求联网协作
- Git 只是本地版本管理。
- 不代表发布。
- 不代表公开。
- 不代表上传。
规则执行：本地提交可以做，远程相关动作一律不做，除非你明确要求。
原创文章，作者：开心电脑网，如若转载，请注明出处。
