一、注册与入门

1. 注册账户
   • 访问github.com，点击右上角 “Sign up”
   • 填写用户名 (唯一)、邮箱和强密码，完成验证
2. 登录
   • 点击右上角 “Sign in”，输入用户名 / 邮箱和密码
3. 基本界面
   • 搜索框：查找项目、用户和代码
   • 个人头像：访问个人主页和设置
   • “+” 按钮：创建新项目 / 仓库

二、核心操作：仓库管理

1. 创建仓库

• 点击右上角 “+”→”New repository”
• 填写仓库名 (如 “my-project”) 和描述
• 选择可见性 (Public 免费 / Private 付费)
• 勾选 “Initialize with README”(建议)
• 点击 “Create repository”

2. 上传 / 管理文件

通过网页:

• 在仓库主页点击 “Add file”→”Upload files”
• 选择文件上传，填写提交信息，点击 “Commit changes”

通过命令行 (推荐):

bash

运行

# 克隆仓库到本地
git clone https://github.com/your-username/repo-name.git

# 进入仓库目录
cd repo-name

# 添加文件到暂存区
git add .  # 添加所有文件
git add filename  # 添加特定文件

# 提交更改
git commit -m "有意义的提交信息"

# 推送到远程仓库
git push origin main  # main是默认分支名

三、协作开发：Fork 与 Pull Request

贡献开源项目流程:

1. Fork 仓库
   • 访问目标项目页面，点击右上角 “Fork” 按钮
   • GitHub 会在你的账户下创建一个仓库副本
2. 克隆到本地并开发bash运行# 克隆你的Fork仓库 git clone https://github.com/your-username/repo-name.git # 添加原始仓库为上游 git remote add upstream https://github.com/original-owner/repo-name.git # 创建功能分支 git checkout -b feature/new-feature
3. 提交更改并推送bash运行# 编辑文件... git add . git commit -m "feat: 添加新功能" git push origin feature/new-feature
4. 创建 Pull Request (PR)
   • 回到 GitHub，进入你的 Fork 仓库
   • 点击 “Pull requests”→”New pull request”
   • 选择对比分支 (你的 feature 分支 vs 原仓库 main 分支)
   • 填写清晰的标题和描述，关联相关 Issue (如修复 bug)
   • 点击 “Create pull request”
5. 代码审查与合并
   • 原项目维护者审查代码，可评论、建议修改或批准
   • 批准后，点击 “Merge pull request” 完成合并

四、项目管理：Issues 与 Projects

1. 使用 Issues 跟踪任务

• 在仓库主页点击 “Issues”→”New issue”
• 填写标题 (如 “登录页面 bug”) 和详细描述
• 添加标签、分配负责人、设置里程碑
• 问题解决后点击 “Close issue” github.net.cn

与 PR 关联: 在 PR 描述中使用 “Fixes #123″(123 为 Issue 编号)，合并后自动关闭对应 Issue

2. 使用 Projects 管理工作流

• 点击 “Projects”→”New project”
• 选择模板 (如 Basic Kanban)，添加列 (To Do/In Progress/Done)
• 将 Issue 或 PR 拖入不同列，可视化进度 github.net.cn

五、其他实用功能

1. 分支管理

• 查看分支：git branch
• 创建分支：git checkout -b new-branch
• 切换分支：git checkout branch-name
• 合并分支：git merge feature-branch

2. 搜索技巧

• 在 GitHub 首页搜索框直接查询项目名
• 使用限定符：如user:username repo:repo-name查找特定仓库

3. GitHub Pages (静态网站托管)

• 在仓库设置中启用 GitHub Pages
• 选择发布源 (如 main 分支的 docs 文件夹)
• 生成专属 URL：https://your-username.github.io/repo-name

六、推荐工作流程

1. 个人项目:
   • 创建仓库→初始化 README→本地开发→提交→推送
2. 团队协作:
   • 创建仓库→添加协作者→创建 Issue→开发分支→PR→审查→合并
3. 开源贡献:
   • Fork→克隆→创建特性分支→提交→PR→审查→合并→同步 Fork

总结

GitHub 是开发者的社交平台，掌握其核心功能可大幅提升协作效率：

• 仓库管理: 代码版本控制的基础
• Fork/PR: 开源协作的核心机制
• Issues/Projects: 任务管理与项目跟踪
• 命令行操作: 高效开发的必备技能