以下是一份從頭到尾、覆蓋安裝、配置、創建倉庫、上傳項目到 GitHub 的完整教程。全程使用通用示例,不包含任何具體的倉庫鏈接,僅供參考。
一、準備工作
1. 注冊 GitHub 賬號
-
打開瀏覽器,訪問 GitHub 官網(輸入 “GitHub” 即可找到)。
-
點擊“Sign up”或“注冊”按鈕,按提示輸入郵箱、用戶名、密碼,并完成郵箱驗證。
-
登陸后,進入個人主頁,即可進行后續操作。
二、安裝并配置 Git
1. 在不同操作系統上安裝 Git
-
Windows:
-
打開瀏覽器,搜索“Git Windows安裝”并找到官網的下載頁面。
-
下載最新版本的安裝包(通常是以
.exe
結尾的文件),雙擊運行后一路“Next”完成安裝。 -
安裝過程中保持默認設置即可(除非你有特殊需求)。
-
-
macOS:
-
可以通過包管理器安裝(推薦 Homebrew)。在終端中執行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew install git
如果不想使用 Homebrew,也可以直接下載 macOS 安裝包,按照提示安裝。
-
-
Linux(以 Ubuntu 為例):
打開終端,執行:sudo apt update sudo apt install git -y
安裝完成后,在任意終端(Windows 下可打開 Git Bash)里輸入:
git --version
如果輸出類似 git version 2.x.x
,說明安裝成功。
2. 全局配置 Git 用戶信息
安裝完成后,需要告訴 Git 是誰在提交代碼。打開終端,依次執行:
git config --global user.name "你的用戶名"
git config --global user.email "你的郵箱@example.com"
-
user.name
:填寫你在 GitHub 上注冊的用戶名或昵稱。 -
user.email
:填寫與你 GitHub 帳號綁定的郵箱地址。
配置完畢后,可以用下面命令檢查:
git config --global --list
會看到類似:
user.name=你的用戶名
user.email=你的郵箱@example.com
三、為安全驗證配置 SSH(可選,但推薦)
使用 SSH 方式推送/拉取代碼,可以避免每次輸入用戶名和密碼(Token)。下面介紹 SSH 公鑰的生成與添加。
1. 生成 SSH 密鑰對
-
打開終端(或 Git Bash),執行:
ssh-keygen -t ed25519 -C "你的郵箱@example.com"
-
按提示一路回車即可,默認會在用戶主目錄下生成
.ssh/id_ed25519
(私鑰)和.ssh/id_ed25519.pub
(公鑰)兩個文件。 -
如果提示 “文件已存在”,可選擇覆蓋或另存為其他文件名,也可以按提示輸入一個新的名稱。
-
-
生成完成后,執行以下命令查看公鑰內容:
cat ~/.ssh/id_ed25519.pub
終端會輸出一串以
ssh-ed25519
開頭的字符串,這就是公鑰。
2. 將 SSH 公鑰添加到 GitHub
-
在瀏覽器中,登陸 GitHub,點擊右上角頭像,選擇“Settings”(設置)。
-
在左側欄中找到 SSH and GPG keys,點擊進入。
-
點擊 New SSH key(新增 SSH 密鑰),在“Title”框里可以填寫一個有意義的名字(例如 “My Laptop”),然后把剛才復制的公鑰粘貼到下面的文本框中,最后點擊 Add SSH key。
-
如果 GitHub 要求你輸入賬號密碼或兩步驗證碼,按提示輸入即可。
添加成功后,SSH 驗證就設置完畢。可以測試連接:
ssh -T git@github.com
如果提示類似 “Hi <用戶名>! You've successfully authenticated...” 則說明 SSH 驗證配置正確。
四、在 GitHub 上創建一個空倉庫
-
登陸 GitHub 后,點擊右上角的 “+” 按鈕,選擇 New repository(新建倉庫)。
-
在 “Create a new repository” 頁面填寫:
-
Repository name:為你的項目起個名字,例如
my-project
。 -
Description(可選):添加簡短描述。
-
Public 或 Private:根據需要選擇公開或私有。
-
Initialize this repository with a README:通常不勾選,否則會自動生成一個 README 文件,后續需要先拉取再推送。
-
-
點擊下方的 Create repository(創建倉庫),稍等片刻后就會進入新倉庫頁面。頁面上會提供 HTTPS 和 SSH 兩種地址,如:
-
HTTPS:
https://github.com/你的用戶名/my-project.git
-
SSH:
git@github.com:你的用戶名/my-project.git
記住這兩個地址中的一種,后續用來關聯本地倉庫。
-
五、將本地項目與遠程倉庫關聯并上傳
下面以一個已存在本地項目的目錄為例,演示如何上傳到 GitHub。假設本地項目文件夾路徑為 ~/projects/my-project
,且目錄下已有若干源代碼或資源文件。
1. 在本地初始化 Git 倉庫
-
打開終端,切換到項目根目錄:
cd ~/projects/my-project
-
在該目錄下執行:
git init
這會創建一個隱藏的
.git/
文件夾,使該目錄成為一個 Git 倉庫。 -
你可以運行
ls -A
或git status
來確認目錄下已有普通文件,但 Git 還沒追蹤它們。
2. 將文件添加到暫存區并提交
-
查看當前狀態(可選):
git status
這時 Git 會告訴你哪些文件是 “Untracked files”(未跟蹤文件)。
-
把所有文件添加到暫存區:
git add .
這樣做會把當前目錄(及子目錄)下所有未被忽略的文件都納入暫存區。
-
創建第一次提交:
git commit -m "首次提交:項目初始化"
以上操作會在本地生成一個提交記錄(commit),大多數情況下會默認在
master
分支上。如果想直接把主分支命名為main
,可以執行:git branch -M main
這樣以后本地倉庫的主分支就是
main
(與 GitHub 通用約定保持一致)。
3. 將本地倉庫與遠程倉庫關聯
-
在本地執行下面命令,將遠程倉庫地址添加為名為
origin
的遠程源:-
使用 HTTPS(需要每次輸入用戶名/密碼或 Token):
git remote add origin https://github.com/你的用戶名/my-project.git
-
使用 SSH(已配置 SSH 密鑰則無需輸入密碼):
git remote add origin git@github.com:你的用戶名/my-project.git
注意:命令開頭務必是小寫的
git
,不要帶任何隱藏字符或破折號。 -
-
添加成功后,可用下面命令確認:
git remote -v
你會看到類似:
origin https://github.com/你的用戶名/my-project.git (fetch) origin https://github.com/你的用戶名/my-project.git (push)
或者如果用的是 SSH,則顯示:
origin git@github.com:你的用戶名/my-project.git (fetch) origin git@github.com:你的用戶名/my-project.git (push)
4. 推送本地提交到遠程倉庫
-
如果當前分支是
main
:git push -u origin main
如果當前分支是
master
(沒有重命名為main
),則:git push -u origin master
-
-u origin main
的含義是:把本地main
分支推送到遠程origin
,并建立跟蹤關系。以后只需直接執行git push
即可。
-
-
在推送過程中,如果使用 HTTPS,需要輸入 GitHub 用戶名和密碼(如果啟用了兩步驗證,則輸入 Personal Access Token);如果使用 SSH,且 SSH key 已配置好,則不會再提示輸入密碼。
-
推送成功后,終端會顯示類似:
Enumerating objects: 10, done. Counting objects: 100% (10/10), done. Compressing objects: 100% (7/7), done. Writing objects: 100% (10/10), 1.23 KiB | 1.23 MiB/s, done. Total 10 (delta 0), reused 0 (delta 0) To https://github.com/你的用戶名/my-project.git* [new branch] main -> main branch 'main' set up to track 'origin/main'.
-
刷新瀏覽器,打開 GitHub 上該倉庫頁面,就能看到你剛才上傳的所有文件。
六、后續開發與同步
項目上傳成功后,后續只需按照下面步驟更新遠程倉庫即可。
1. 修改/新增文件后上傳
-
在本地對文件進行修改或新增文件。
-
查看項目狀態:
git status
可以看到哪些文件被修改、哪些是新文件。
-
添加改動到暫存區:
-
如要一次添加所有改動:
git add .
-
如果只想添加某個文件:
git add path/to/yourfile.ext
-
-
提交改動:
git commit -m "本次更新:簡要說明修改內容"
-
推送到遠程:
git push
由于第一次已經用
-u origin main
或-u origin master
與遠程分支建立了跟蹤關系,后續直接git push
即可。
2. 如果遠程倉庫有了新的提交(多人協作時常見)
-
在推送之前,可以先拉取遠程更新:
git pull --rebase origin main
或者:
git pull origin main
-
帶
--rebase
可以保持提交歷史線性;不帶則會自動創建一個合并提交(Merge commit)。
-
-
如果出現沖突(Conflict),按提示打開沖突文件,手動保留、刪除沖突標記(
<<<<<<<
、=======
、>>>>>>>
),然后執行:git add 沖突已解決的文件 git rebase --continue # 如果使用了 --rebase
或者如果是普通
git pull
:git add 沖突已解決的文件 git commit
沖突解決完成后再執行
git push
,即可把本地改動與遠程最新內容同步。
七、常見問題與注意事項
-
命令前不要出現隱藏字符
-
如果復制粘貼時前面多了不可見破折號(如 “?”)或空格,Git 會識別為非法命令,從而提示 “command not found”。遇到這種情況,請按幾次退格鍵把前導的隱藏字符清除,然后再手動輸入
git init
、git add
等命令。
-
-
.gitignore 文件
-
在項目根目錄創建一個名為
.gitignore
的文件,寫入你不想跟蹤(即不想上傳到遠程)的文件或文件夾規則。常見示例:node_modules/ *.log .env .DS_Store build/ *.pyc
-
這樣做可以避免把編譯生成的臨時文件、IDE 配置、依賴包等無關文件上傳到倉庫。
-
-
分支管理
-
默認情況下,你會在
main
(或master
)分支上工作。如果想開發新功能、修復 Bug,通常會新建分支:git checkout -b feature/新功能名稱
-
完成開發并測試通過后,切回
main
分支并合并:git checkout main git merge feature/新功能名稱 git branch -d feature/新功能名稱
-
合并完成后,再執行
git push
即可把合并后的結果推到遠程。
-
-
SSH 與 HTTPS
-
如果長時間需要頻繁推送,推薦使用 SSH 方式,只需在本地生成過一次 SSH 密鑰,并把公鑰添加到 GitHub,就不需要每次輸入用戶名/密碼或 Token。
-
如果安全要求較高或不方便配置 SSH,也可以繼續使用 HTTPS,但每次推送時都可能需要輸入 Token。
-
-
Token 和安全
-
GitHub 已逐步棄用直接使用密碼進行 HTTPS 驗證,強制使用個人訪問令牌(Personal Access Token)。
-
在終端推送時,如果提示要求用戶名和密碼,你可以把用戶名填為 GitHub 用戶名,然后把個人訪問令牌粘貼到密碼處。訪問令牌可以在 GitHub 個人設置里新建。
-
-
遠程倉庫已初始化 README 情況
-
如果你在新建倉庫時勾選了“初始化 README”,遠程倉庫就會自帶一個提交記錄。這時本地一開始是空的,如果你直接執行
git push
會被拒絕(提示需要先拉取遠程更改)。解決方法是先執行:git pull --rebase origin main
把遠程的那次提交拉下來并合并到本地,然后再
git push
。
-
八、小結
-
安裝 Git 并配置
user.name
、user.email
。 -
(可選)配置 SSH 密鑰,將公鑰添加到 GitHub。
-
在 GitHub 上創建一個空倉庫(不勾選初始化 README)。
-
在本地項目目錄執行
git init
,將項目轉為 Git 倉庫。 -
執行
git add .
、git commit -m "描述"
,完成首次提交。 -
使用
git remote add origin <遠程倉庫地址>
關聯遠程。 -
執行
git push -u origin main
(或master
)將本地提交推送到 GitHub。 -
后續開發:用
git add
→git commit
→git push
完成更新。若需合并遠程改動,先git pull --rebase
再git push
。
以上步驟涵蓋了從安裝軟件到首次上傳,再到后續代碼同步的完整流程。只要每一步都按照說明并自己手動輸入命令,就能順利把項目上傳并保持與 GitHub 的同步。