2-Github 基础 - 《Microsoft 面向初学者的 Web 开发课程》

GitHub 基础入门教程
- 📚 本课程介绍了 GitHub 的基础知识，包括托管和管理代码的版本控制平台。
✅ 课前测验
🚀 本课涵盖内容：
⚙️ 前置条件：
🛠️ 代码管理
🔥 创建 Git 仓库并提交代码
💡 提交信息规范
👥 与他人协作
🌟 开源贡献指南
📌 GitHub 常用功能
🎯 挑战任务
✅ 课后测验
📚 自学与复习

GitHub 基础入门教程

📚 本课程介绍了 GitHub 的基础知识，包括托管和管理代码的版本控制平台。

GitHub 入门

手绘笔记由 Tomomi Imura 提供

✅ 课前测验

课前测验

🚀 本课涵盖内容：

在本地机器上跟踪代码版本
与他人协作开发项目
如何为开源项目贡献代码

⚙️ 前置条件：

检查 Git 是否安装：
在终端运行：
```
git --version
```
如果 Git 未安装，下载 Git。

配置 Git 个人信息：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

检查当前配置：

git config --list

环境准备：
- GitHub 账号
- 代码编辑器（如 VS Code）
- 打开终端或命令行工具
- 登录 GitHub 并创建账户

✅ GitHub 是最知名的代码托管平台，但不是唯一的选择。

🛠️ 代码管理

你可以使用 Git 管理项目的版本历史，这就像是给未来的自己写信，帮助回顾当时的开发决策。

🔥 创建 Git 仓库并提交代码

✅ 视频教程

在 GitHub 上创建仓库
- 登录 GitHub，点击右上角的 New Repository 按钮
- 填写仓库名称，点击 Create Repository
在本地创建 Git 仓库
- 打开终端，切换到项目目录：
```
cd 项目目录
```
- 初始化 Git 仓库：
```
git init
```
检查仓库状态
```
git status
```
添加所有文件到暂存区
```
git add .
```
添加指定文件到暂存区
```
git add 文件名
```
取消暂存
- 取消所有文件：
```
git reset
```
- 取消指定文件：
```
git reset 文件名
```
提交代码
```
git commit -m "首次提交"
```

连接 GitHub 仓库

在 GitHub 上复制仓库地址

在终端运行：

git remote add origin https://github.com/你的用户名/仓库名.git

推送代码到远程仓库
```
git push -u origin main
```

后续提交

持续更新代码：

git add .
git commit -m "你的提交信息"
git push

✅ 使用 .gitignore 文件忽略不需要提交的文件，例如环境变量或本地配置文件。

💡 提交信息规范

提交信息应使用 祈使句，如：
- ✅ fix: 修复登录 bug
- ✅ feat: 新增用户搜索功能
不要使用过去式或第三人称：
- ❌ fixed bug
- ❌ added feature
提交信息格式：
```
<type>: <subject>
<body>（可选）
```
常见类型：
- feat: 新功能
- fix: 修复 bug
- docs: 文档更新
- style: 格式调整（不影响代码逻辑）
- refactor: 重构代码
- test: 测试代码

✅ 编写清晰的提交信息有助于回溯和协作。

👥 与他人协作

✅ 视频教程

创建分支
```
git branch 分支名
```
切换分支
```
git switch 分支名
```
合并主分支最新代码
```
git switch main
git pull
```
合并分支
```
git switch 分支名
git merge main
```

推送到远程仓库

git push --set-upstream origin 分支名

创建 PR（合并请求）
- 打开 GitHub 仓库
- 点击 Pull Request 并填写说明
- 提交合并请求

✅ 合并 PR 后清理本地分支：

git branch -d 分支名

🌟 开源贡献指南

在 GitHub 搜索带有 good-first-issue 标签的开源项目
Fork 仓库并克隆到本地：
```
git clone 仓库地址
```
新建分支并进行开发：
```
git checkout -b feature-branch
```

提交代码并推送：

git add .
git commit -m "feat: 添加新功能"
git push origin feature-branch

提交 PR

📌 GitHub 常用功能

Star：收藏感兴趣的项目
Fork：复制项目到自己的账户
Issues：跟踪和讨论项目问题
Pull Request：合并请求，协作开发
Codespaces：GitHub 在线开发环境

✅ 尝试在 GitHub 上探索设置、项目和看板功能。

🎯 挑战任务

与朋友协作开发，练习 Fork、分支管理和合并代码。

✅ 课后测验

课后测验

📚 自学与复习

阅读开源贡献指南：如何贡献
Git 快速参考：Git Cheatsheet
GitHub 学习路径：GitHub Skills
推荐课程：
- GitHub 入门

✅ 多多练习，掌握 Git 与 GitHub 的版本控制与协作开发！ 🚀