1. 創建GitHub專案

創建專案資料夾後，如何放上GitHub讓其他人一起來協同開發呢?

(以下指令詳細的意思都會在第二章做詳細的解釋)

第一步：在 GitHub 上建立新的儲存庫 (Repository)

  1. 登入 GitHub。
  2. 點擊右上角的 「+」，選擇 New repository。
  3. 輸入專案名稱（Repository name），其他設定（如 Public/Private）依你喜好，不要勾選 Initialize this repository with a README（保持專案完全空白）。
  4. 點擊 Create repository。
  5. 建立成功後，你會看到一個頁面，複製畫面上那串 https://github.com/你的帳號/你的專案.git 的網址。

第二步：在本地終端機輸入指令

我們先在電腦上建立一個新資料夾my-project，來模擬專案。

打開終端機，切換到你該專案的資料夾路徑下（cd my-project），然後依序輸入以下指令：

1. 初始化本地 Git 儲存庫

git init

2. 將檔案加入暫存區

我們用指令創建一個index.html並將其放上GitHub

echo "<h1>Hello Git! This is my first app.</h1>" > index.html
git add index.html
Code language: HTML, XML (xml)

3. 提交檔案並加上紀錄訊息

git commit -m "First commit: Create index.html"
Code language: JavaScript (javascript)

4. 設定預設分支名稱為 main

我們設置一個main分支來代表正式版本專案。

git branch -M main

5. 連結本地專案與 GitHub 遠端儲存庫

請將下方的網址替換成你在第一步複製的 GitHub 網址：

git remote add origin https://github.com/你的帳號/你的專案.git
Code language: JavaScript (javascript)

6. 將檔案推送到 GitHub

git push -u origin main

(註：-u 參數是設定上游專案，以後只要輸入 git push 就會自動推送到這裡了。)

💡 如果在 git push 時遇到錯誤，你需要去 GitHub 設定裡產生一個 Personal Access Token (PAT) 當作密碼輸入，或者設定好 SSH Key。

恭喜你成功完成第一個github專案了，接下來我們來看看日常開發中又該如何使用git呢!

3. 加入協同編輯成員

接著我們可以把要一起開發這個專案的組員加進我們的github讓他可以執行之後的push操作:

進到你的 GitHub 專案首頁後，點擊 Settings:

  1. 找到 Collaborators：在左側的導覽欄中，找到 Access 區塊，點擊裡面的 👥 Collaborators。(這時候系統為了安全，可能會要求你輸入一次 GitHub 密碼或進行雙重驗證)
  2. 點擊新增按鈕：在畫面上會看到一個綠色的按鈕 Add people。
  3. 搜尋並邀請：在彈出的視窗中，輸入對方的 GitHub 帳號名稱（Username）、全名 或 Email，找到他之後點選加入。

對方必須「收信接受」才算成功！

此時畫面上會顯示 Pending Invite（等待接受邀請）。請提醒你的夥伴： 他必須去他註冊 GitHub 的 Email 信箱 收信，或者直接請他登入 GitHub 點擊你給他的專案網址，畫面上會跳出一個邀請通知，他點選 Accept invitation（接受邀請） 之後，他就正式加入你的專案，可以開始 push 囉！