GS Git Start Book Learn by reading and shipping

Lab 2

將本機專案推送到 GitHub

Lab 1 是從 GitHub 建立 repo 再 clone 下來。這次反過來:從本機已有的專案開始,連接到 GitHub 並推送。

練習目標

  • 把本機已有的資料夾初始化為 Git repository
  • 在 GitHub 建立對應的空 repository
  • 設定遠端連結並完成第一次 push

先備條件

  • 已完成 Lab 1
  • 本機有一個想要推到 GitHub 的資料夾(可用 Lab 1 建立的專案繼續操作)
  • GitHub 帳號已登入

操作步驟

1

進入本機專案資料夾

在終端機切換到你的專案目錄:

cd /path/to/your-project
2

初始化 Git(若尚未 init)

如果這個資料夾還不是 Git repository:

git init
3

建立第一個 commit

把現有的所有檔案 stage 起來並 commit:

git add .
git commit -m "initial commit"
4

在 GitHub 建立空 repository

前往 GitHub,點擊右上角 +New repository。名稱與本機資料夾相同會比較好管理。不要勾選「Initialize this repository with a README」。

5

設定遠端連結

複製 GitHub 上顯示的 HTTPS 網址,回到終端機執行:

git remote add origin https://github.com/your-account/your-project.git
6

推送到 GitHub

git branch -M main
git push -u origin main

第一次推送需要 -u origin main 設定上游。之後只需要 git push

驗證成功

  • 打開 GitHub 網頁,repository 裡可以看到你的檔案
  • Commits 頁面顯示 "initial commit"
  • 執行 git remote -v 可看到 origin 指向正確的 URL

常見問題

push 時要求輸入密碼

GitHub 已停止支援密碼驗證。請改用 Personal Access Token(PAT)或設定 SSH key。建議前往 GitHub Settings → Developer settings → Personal access tokens 產生 token,推送時輸入 token 取代密碼。

error: remote origin already exists

表示已設定過 remote。可以用 git remote set-url origin 新網址 更新,或先 git remote remove origin 再重新 add。