独立开发者 Git 标准操作手册 (Solo Developer Git Workflow)

独立开发者 Git 标准操作手册 (Solo Developer Git Workflow)#

0. 环境配置 (仅首次安装需设置)#

在开始之前，你需要告诉 Git “你是谁”。这会记录在每一次存档（Commit）中。

打开终端（Terminal/CMD/PowerShell）输入：

# 设置你的名字
git config --global user.name "你的英文名"

# 设置你的邮箱 (最好和你的 GitHub 邮箱一致)
git config --global user.email "你的邮箱@example.com"

# (可选) 让 Git 输出的日志带颜色，更易读
git config --global color.ui auto

1. 项目初始化 (Project Setup)#

当你新建一个文件夹准备写软件时，执行以下步骤。

1.1 初始化仓库#

cd /path/to/your/project  # 进入项目文件夹
git init                  # 把这个文件夹变成 Git 仓库

1.2 创建“忽略名单” (非常重要！)#

防止垃圾文件（日志、编译产物、系统缓存）污染版本记录。

  1. 在根目录新建一个名为 .gitignore 的文件（注意前面有点）。

  2. 写入你不需要备份的文件类型。例如 Python 项目：

    __pycache__/
*.pyc
.env          # 包含密钥的环境变量文件，千万别上传
.DS_Store     # Mac 系统产生的垃圾文件
/venv/        # 虚拟环境文件夹

    提示： 不知道怎么写？去 gitignore.io 搜索你的语言（如 Python, Node, C++），复制粘贴生成的内容即可。

2. 日常开发循环 (The Daily Loop)#

这是你在 main 分支或者开发分支上每天重复动作。

步骤 A：查看当前情况 (GPS)#

不管做任何操作前，先养成看状态的习惯。

git status
  • 红色文件： 改了但还没放入暂存区。
  • 绿色文件： 已经放入暂存区，准备存档。

步骤 B：暂存修改 (Packing)#

把你觉得满意的修改放入“待提交区”。

git add .          # 将所有修改过的文件全部暂存 (常用)
# 或者
git add filename   # 只暂存指定文件

步骤 C：正式存档 (Commit)#

git commit -m "动词+名词：描述你做了什么"
  • ✅ 好的例子：git commit -m "修复登录页面的空指针崩溃"
  • ❌ 坏的例子：git commit -m "update" (时间久了你根本不知道这次存了什么)

3. 分支管理：功能开发标准流 (Feature Workflow)#

这是解决你“备份文件夹”痛点的核心流程。 只要开发新功能，严禁直接在 main 分支修改。

场景：你要开发一个“深色模式”功能#

第一步：创建并切换到新分支#

这就相当于复制了一份项目副本。

# -b 表示创建并切换 (branch + checkout)
git checkout -b feat/dark-mode

第二步：在这个分支上尽情折腾#

编写代码、调试、测试。期间你可以进行多次 add 和 commit。

git add .
git commit -m "完成深色模式的CSS框架"
...
git add .
git commit -m "增加切换按钮的逻辑"

第三步：功能完成，合并回主线#

确认功能完美后，把副本的代码合并回去。

# 1. 先切回主分支
git checkout main

# 2. 把 feat/dark-mode 的成果合并进来
git merge feat/dark-mode

第四步：清理现场#

副本已经没用了，删除它。

git branch -d feat/dark-mode

4. 后悔药 (Rollback & Undo)#

这是你敢于大胆修改代码的底气。

情况 A：代码改乱了，还没 add/commit#

想把某个文件（或全部文件）恢复到上次存档的样子。

# 慎用！这会丢弃你当前工作区的所有未保存修改
git checkout .

情况 B：已经 commit 了，但发现有重大 Bug#

想撤销上一次的存档，把代码状态退回到 commit 之前（保留代码，只是撤销“存档”这个动作）。

git reset --soft HEAD^
  • HEAD^ 意思是指向的上一个版本。
  • --soft 意思是“软着陆”，你的代码修改都会保留在暂存区，你可以修改后重新 commit。

5. 异地容灾 (Sync with GitHub)#

为了防止电脑硬盘损坏，或者需要在另一台电脑开发。

5.1 关联远程仓库 (仅第一次)#

在 GitHub 上新建一个空仓库 (Repository)，然后：

# origin 是给远程仓库起的别名
git remote add origin https://github.com/你的用户名/仓库名.git

5.2 上传代码 (Push)#

# -u 表示关联默认分支，以后直接 git push 即可
git push -u origin main

5.3 下载代码 (Clone/Pull)#

  • 新电脑下载项目： git clone https://github.com/xxx/xxx.git
  • 在老电脑获取最新代码： git pull

6. TAG 和 release#

使用命令 

git -tag -a v0.0.* -m "说明"

创建Tag。Pull到Github上可以创建Releases。

git push origin v1.0.0

7. 独立开发者最佳实践清单#

  1. 原子提交 (Atomic Commits)： 尽量保证一个 Commit 只做一件事。不要把“修复Bug A”和“开发功能 B”混在一个 Commit 里。
  2. 不要上传敏感信息： 数据库密码、API Key 永远不要 Commit！用 .env 文件管理并加入 .gitignore。
  3. 频繁提交： 就像写文档随手 Ctrl+S 一样，写好一个小函数就 Commit 一次。
  4. 善用 GUI 工具辅助： 虽然命令行很强，但用 VS Code 或 JetBrains 系列 IDE 自带的 Git 界面来查看 Diff（代码差异）会比看命令行直观得多。

你的下一步#

建议你现在的操作：

  1. 打开你正在开发的那个“让人头大”的项目文件夹。
  2. 执行 git init。
  3. 立刻去生成一个 .gitignore 文件放入根目录。
  4. 执行 git add . 和 git commit -m "Initial commit: 项目初始化"。

做完这4步，你现有的代码就已经被 Git 保护起来了。如果在这个过程中遇到任何报错（比如提示文件被占用等），随时发给我，我帮你排查。