步驟 1：檢查是否已有 SSH Key

開啟 PowerShell：

ls ~/.ssh

如果看到像下面的檔案：

id_ed25519
id_ed25519.pub

或

id_rsa
id_rsa.pub

代表你已經有 SSH Key，可以直接跳到步驟 4。

步驟 2：建立 SSH Key（推薦 Ed25519）

將 your_email@example.com 改成你 GitHub 註冊的 Email：

ssh-keygen-t ed25519-C"your_email@example.com"

例如：

ssh-keygen-t ed25519-C"abc@gmail.com"

接著會看到：

Enter file in which to save the key:

直接按 Enter。 接著：

Enter passphrase:

• 不想每次輸入密碼 → 直接按 Enter
• 想增加安全性 → 設定一組密碼 最後會看到：

Your identification has been saved in ...
Your public key has been saved in ...

表示建立成功。

步驟 3：啟動 SSH Agent

PowerShell：

Get-Service ssh-agent

如果沒有啟動：

Start-Service ssh-agent

然後加入金鑰：

ssh-add ~/.ssh/id_ed25519

成功會顯示：

Identity added:

---

步驟 4：複製公開金鑰

Windows 可以直接：

Get-Content ~/.ssh/id_ed25519.pub

或

cat ~/.ssh/id_ed25519.pub

會看到一長串：

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... your_email@example.com

全部複製。

步驟 5：加入 GitHub

登入 GitHub：

1. 點右上角頭像。
2. Settings。
3. SSH and GPG keys。
4. 點 New SSH key。
5. 輸入：

• Title：例如 My Laptop
• Key type：Authentication Key
• Key：貼上剛剛複製的內容。

6. 按 Add SSH key。

---

步驟 6：測試是否成功

執行：

ssh-Tgit@github.com

第一次會詢問：

Are you sure you want to continue connecting?

輸入：

yes

如果成功，會看到：

Hi <你的 GitHub 帳號>! You've successfully authenticated, but GitHub does not provide shell access.

---

步驟 7：把 Repository 改成 SSH 網址

查看目前網址：

git remote-v

如果看到：

https://github.com/你的帳號/專案.git

改成 SSH：

git remote set-url origingit@github.com:你的帳號/專案.git

再確認一次：

git remote-v

應該會變成：

origin  git@github.com:你的帳號/專案.git (fetch)
origin  git@github.com:你的帳號/專案.git (push)

之後就可以直接：

git push

不用再輸入 GitHub 帳號和密碼。

Git 第一次上傳 GitHub 完整流程

Step 1：進入專案資料夾

確認目前位於專案根目錄。

cd 專案資料夾

例如：

cd C:\Users\TMP-214\Desktop\todolist

---

Step 2：初始化 Git Repository

建立 Git Repository。

git init

執行後會看到：

Initialized empty Git repository...

---

Step 3：設定 Git（第一次安裝 Git 才需要）

設定作者名稱：

git config--global user.name"你的GitHub名稱"

例如：

git config--global user.name"dumpling87"

設定 Email（建議與 GitHub 帳號綁定的 Email 相同）：

git config--global user.email"你的Email"

例如：

git config--global user.email"dumpling8877@gmail.com"

設定新 Repository 預設分支：

git config--global init.defaultBranch main

---

Step 4：建立 .gitignore

建立：

.gitignore

Node.js 專案建議內容：

node_modules/
.env
*.log

避免將：

• node_modules
• API Key
• Log 推到 GitHub。

---

Step 5：確認哪些檔案會被加入 Git

git status

確認： ✅ 要上傳的檔案有出現 ❌ .env ❌ node_modules 沒有出現。

Step 6：加入暫存區（Stage）

將目前所有檔案加入暫存區：

git add .

也可以加入單一檔案：

git add app.js

再次確認：

git status

看到：

Changes to be committed

表示成功。

Q1：不小心 git add . 怎麼辦？

取消全部暫存：

git restore--staged .

取消單一檔案：

git restore--staged 檔名

---

Step 7：建立第一個 Commit

建立版本紀錄：

git commit-m"Initial commit"

例如：

git commit-m"完成 Todo API"

查看 Commit：

git log--oneline

例如：

8a5d4b4 Initial commit

---

Step 8：GitHub 建立 Repository

登入 GitHub。 點選：

New Repository

輸入：

Repository Name

例如：

node-todolist

不要勾選 ❌ README ❌ .gitignore ❌ License 因為本地專案已經有 Git 紀錄。

Step 9：加入遠端 Repository

GitHub 會提供 Repository URL。 例如：

https://github.com/dumpling871008/node-todolist.git

加入遠端：

git remote add origin https://github.com/dumpling871008/node-todolist.git

確認：

git remote-v

成功會看到：

origin  https://github.com/dumpling871008/node-todolist.git (fetch)
origin  https://github.com/dumpling871008/node-todolist.git (push)

---

Step 10：第一次 Push

推送到 GitHub：

git push-u origin main

第一次需要 -u。 之後只要：

git push

即可。

Q：Push 時出現

error: src refspec main does not match any

通常表示：

• 還沒有 git commit
• 或目前分支不是 main 可以檢查：

git branch
git log--oneline

---

之後每次更新專案流程

修改程式後：

git status

↓

git add .

↓

git commit-m"新增 PATCH API"

↓

git push

---

常用 Git 指令速查

指令	功能
`git status`	查看目前狀態
`git add .`	加入所有變更到暫存區
`git add 檔名`	加入指定檔案
`git commit -m "訊息"`	建立一個版本
`git log --oneline`	查看 Commit 紀錄
`git remote -v`	查看遠端 Repository
`git push`	上傳到 GitHub
`git pull`	從 GitHub 下載最新版本
`git branch`	查看目前分支

指令	用途	範例
`cd path`	移動到指定目錄	`cd /tmp`（移動到 `/tmp` 目錄）`cd ..`（移動到上一層目錄）
`echo "xxx" > file`	建立一個檔案，並將文字寫入檔案	`echo "test123" > test.txt`
`mkdir tmpdir`	建立新目錄	`mkdir /tmp/test`（在 `/tmp` 下建立 `test` 目錄）
`mv path1 path2/`	將檔案或目錄移動到指定位置	`mv /tmp/file /tmp/test/`（將 `file` 移到 `/tmp/test/`）
`mv old new`	將檔案或目錄重新命名	`mv /tmp/file /tmp/file_new`（將 `file` 改名為 `file_new`）
`rm file`	刪除檔案（不能刪除目錄）	`rm /tmp/file`
`rmdir folder`	刪除空目錄	`rmdir /tmp/test`（`test` 必須是空目錄）
`rm -r folder`	遞迴刪除目錄及其所有內容	`rm -r /tmp/test`
`pwd`	顯示目前所在目錄	`pwd`
`ls -la`	列出目前目錄所有檔案（包含隱藏檔）及詳細資訊	`ls -la`