GitHub 简明指南
一、核心概念快速理解
1. 仓库数据三兄弟
- Star（收藏）：给项目点赞，表示喜欢
- Watch（关注）：订阅通知，项目更新会收到提醒
- Fork（复制）：完整克隆项目到自己的账户
关键点：收藏数通常远大于关注数，因为关注意味着深度参与。
2. Fork vs Branch
- Fork：复制整个仓库（外部贡献者用）
- Branch：在仓库内创建分支（团队成员用）
二、Fork 机制：三步理解
1. 什么是 Fork？
把别人的项目完整复制一份到你的 GitHub 账户，变成你的独立仓库。
2. Fork 后能做什么？
- 随意修改代码，不影响原项目
- 可以添加新功能、修复 Bug
- 随时向原项目提交改进建议
3. 标准流程
网页点击 Fork → Clone 到电脑 → 修改代码 → 推送 → 发起 Pull Request
三、两种协作方式
方式一：Fork & Pull（开源项目常用）
- 谁用：外部贡献者、社区开发者
- 特点：无需权限，在自己副本上开发
- 流程：复制 → 修改 → 提建议
方式二：Branch & Push（团队内部用）
- 谁用：团队成员、合作同事
- 特点：需要权限，在同一个仓库内开发
- 流程：创建分支 → 修改 → 直接推送
四、Public vs Private 关键区别
| 功能 | 公开仓库 | 私有仓库 |
|---|---|---|
| 谁能看到 | 所有人 | 仅受邀者 |
| 能否 Fork | ✅ 可以 | ❌ 禁止 |
| 协作方式 | 两种都行 | 只能 Branch |
| 适用场景 | 开源项目、学习 | 商业代码、内部工具 |
简单记：公开项目两种方式都能用，私有项目只能给权限的人在内部协作。
五、三个重要提醒
1. 分支是安全的
- 创建分支后，主分支再怎么改都不会自动影响你的分支
- 只有当你主动合并时，才需要处理可能的冲突
2. Fork 需要手动同步
- 原项目更新后，你的 Fork 不会自动更新
- 需要定期手动拉取原项目的新内容
3. 权限控制很重要
- 公开项目：欢迎所有人贡献，但保护主分支
- 私有项目：严格控制谁能访问，按需分配权限
六、发布版本管理：Release 功能
Release 是什么？
- 软件正式版本发布，像 App Store 的版本更新
- 基于 Git 标签（Tag）创建，包含版本说明和可下载文件
核心用途：
- 版本存档：永久保存每个重要版本
- 用户分发：提供编译好的安装包/二进制文件
- 更新说明：清晰记录每个版本的变化内容
快速使用：
创建步骤：
1. 代码稳定后打标签：git tag -a v1.0.0
2. 推送标签：git push origin v1.0.0
3. 在 GitHub 网页完善 Release 信息
4. 上传附件文件（可执行程序、安装包等）
用户获取：
项目首页 → 点击 "Releases" → 选择版本 → 下载文件
语义化版本建议：
v1.0.0：第一个稳定版v1.1.0：新增功能（向后兼容）v1.0.1：修复问题v2.0.0：重大更新（可能不兼容）
七、快速决策指南
问自己三个问题：
-
代码是否敏感？
- 是 → 用 Private
- 否 → 用 Public
-
希望谁参与？
- 全世界 → Public + Fork
- 仅团队 → Private + Branch
-
主要目的是什么？
- 开源协作 → Public
- 商业开发 → Private
八、一句话总结
GitHub 协作就是：公开项目让别人复制改进，私有项目只给信任的人直接修改，无论哪种都要保护主分支安全。Release 功能让你的项目从代码仓库变成可发布的软件产品。
记住：Star 是点赞，Watch 是订阅，Fork 是复制，Release 是发版。公开项目两种协作都行，私有项目只能内部协作。