# Git 教學

## 簡介
Git 是一個分散式版本控制系統，GitHub 是一個基於 Git 的代碼託管平台。本教學將指導您如何使用基本的 Git 指令以及如何在 GitHub 上創建 Pull Request。

## 初始化倉庫
要開始使用 Git，您需要初始化一個倉庫。可以使用以下命令完成：
```shell
git init
```
此命令會在當前目錄中創建一個新的 Git 倉庫。

## 克隆倉庫
如果您想要在現有項目上工作，可以使用以下命令克隆倉庫：
```shell
git clone <repository_url>
```
此命令會在您的本地機器上創建一個倉庫的副本。

## 添加更改
要將更改添加到暫存區，請使用以下命令：
```shell
git add <file_name>
```
您也可以使用以下命令添加當前目錄中的所有更改：
```shell
git add .
```

## 提交更改
一旦您將更改添加到暫存區，您可以使用以下命令提交它們：
```shell
git commit -m "commit message"
```
此命令會將更改記錄在倉庫中，並附上描述更改的消息。

## 推送更改
要將您的更改推送到遠程倉庫，請使用以下命令：
```shell
git push origin <branch_name>
```
此命令會將您的本地更改上傳到遠程倉庫的指定分支。

## 創建和管理分支
分支用於獨立於主代碼庫開發功能或修復錯誤。要創建新分支，請使用以下命令：
```shell
git checkout -b <new_branch_name>
```
要切換到現有分支，請使用：
```shell
git checkout <branch_name>
```
要列出所有分支，請使用：
```shell
git branch
```
要刪除分支，請使用：
```shell
git branch -d <branch_name>
```

## 創建 Pull Request
Pull Request（PR）是一種提交代碼更改的方式。以下是創建 PR 的步驟：

1. 在 GitHub 上 fork 一個倉庫。
2. 將 fork 後的倉庫克隆到本地：
   ```shell
   git clone <forked_repository_url>
   ```
3. 為您的更改創建一個新分支：
   ```shell
   git checkout -b <new_branch_name>
   ```
4. 進行代碼更改並提交：
   ```shell
   git add <file_name>
   git commit -m "commit message"
   ```
5. 將更改推送到您的 fork 倉庫：
   ```shell
   git push origin <new_branch_name>
   ```
6. 轉到 GitHub 上的原始倉庫，點擊 "Compare & pull request" 按鈕。
7. 填寫 PR 的標題和描述，然後點擊 "Create pull request" 按鈕。

## 審查 Pull Request
一旦創建 PR，它可以由其他貢獻者審查。以下是審查 PR 的步驟：

1. 轉到 GitHub 上的 PR。
2. 審查更改並在必要時留下評論。
3. 批准或請求更改 PR。
4. 一旦 PR 獲得批准，它可以合併到主代碼庫中。

## 撤回提交
如果您需要因為提交錯誤而撤回提交，可以使用以下命令：
```shell
git revert <commit_hash>
```
此命令會創建一個新提交，撤銷指定提交所做的更改。

## 結論
本教學涵蓋了基本的 Git 指令以及如何在 GitHub 上創建和審查 Pull Request。通過遵循這些步驟，您可以有效地使用 Git 和 GitHub 來管理和協作開發代碼。