GitHub 上傳檔案完整指南

更新日期： 2024 年 12 月 9 日

GitHub 是開發者管理專案的首選平台之一，能有效協助版本控制與團隊協作。

本篇文章將為新手介紹如何透過 Git 將檔案上傳到 GitHub，並詳細說明相關指令與用法。

設置遠端儲存庫

在將檔案上傳到 GitHub 前，需要將本地專案與遠端儲存庫進行關聯。

新增遠端儲存庫

使用以下指令將 GitHub 儲存庫連結到本地專案：

git remote add origin https://github.com/your-repo.git

• origin：是一個代名詞，類似書籤，用來表示遠端儲存庫的 URL。
• https://github.com/your-repo.git：遠端儲存庫的地址。

此步驟完成後，本地專案就與遠端儲存庫建立了關聯。

查看遠端儲存庫

確認當前設定的遠端儲存庫，使用：

git remote -v

輸出範例：

origin  https://github.com/your-repo.git (fetch)
origin  https://github.com/your-repo.git (push)

• fetch：用於拉取遠端內容。
• push：用於推送本地內容。

移除遠端儲存庫

如果需要更改或刪除目前的遠端設定，可以使用以下指令：

git remote rm origin

此指令會移除 origin 的設定，但不會影響本地檔案。

推送檔案到遠端儲存庫

完成遠端儲存庫的設定後，就可以將本地檔案推送到 GitHub。

基本推送指令

將本地分支的內容推送到遠端儲存庫的指定分支：

git push origin main

• origin：遠端儲存庫的名稱。
• main：本地分支的名稱。

設定預設推送分支

為了減少重複輸入的操作，可以在首次推送時加入 -u 參數：

git push -u origin main

• -u：將遠端儲存庫與本地分支設定為預設。
• 之後執行推送時，只需輸入： git push Git 將自動推送至設定的 origin main。

完整推送語法

推送指令的完整語法如下：

git push origin main:main

main:main：main 是本地分支名稱，冒號後的 main 是遠端分支名稱。

如果要推送到不同的遠端分支，修改冒號後的名稱即可。

例如：

git push origin main:feature 

這表示將本地的 main 分支推送到遠端的 feature 分支。

刪除遠端分支

若需要刪除遠端儲存庫中的分支，可以使用以下指令：

git push origin :main

• :main：表示將空的內容推送到遠端的 main 分支，達到刪除分支的效果。

小結

上傳檔案到 GitHub 的核心步驟包括：

1. 新增遠端儲存庫：git remote add origin <URL>。
2. 推送內容到遠端：git push origin <分支名稱>。
3. 設定預設推送：git push -u origin <分支名稱>。
4. 刪除遠端分支：git push origin :<分支名稱>。

這些指令能幫助新手快速掌握 Git 與 GitHub 的操作，輕鬆完成專案的同步與管理！