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。