1. 準備工作

1.1 安裝 Git
下載并安裝 Git：前往 Git 官網，根據操作系統下載安裝包。
配置用戶名和郵箱（需與 Gitee 賬號一致）：

git config --global user.name "你的Gitee用戶名"
git config --global user.email "你的Gitee注冊郵箱"

1.2 創建 Gitee 倉庫
登錄 Gitee，點擊右上角「+」→「新建倉庫」。
填寫倉庫名稱（如 uniapp-project），選擇「公開」或「私有」，其他選項保持默認。
創建完成后，復制倉庫的 SSH 或 HTTPS 地址（推薦使用 SSH，避免頻繁輸入賬號密碼）。

2. 本地項目關聯 Gitee 倉庫

2.1 初始化本地 Git 倉庫
進入 Uniapp 項目根目錄（含 pages.json 的目錄），右鍵打開命令行，執行：

# 初始化本地倉庫
git init# 添加所有文件到暫存區（注意排除 node_modules 等無用文件）
git add .
# 或手動創建 .gitignore 文件排除不需要提交的目錄（推薦）
# 示例 .gitignore 內容：
node_modules/
unpackage/dist/

2.2 提交本地代碼

# 提交到本地倉庫
git commit -m "初次提交：初始化Uniapp項目"

2.3 關聯遠程倉庫

# 添加遠程倉庫地址（替換為你的Gitee倉庫地址）
git remote add origin git@gitee.com:你的用戶名/倉庫名.git
# 示例：
git remote add origin git@gitee.com:john/uniapp-project.git

3. 推送代碼到 Gitee

3.1 首次推送

# 推送代碼到Gitee的master分支（-u表示關聯默認遠程分支）
git push -u origin master

若使用 HTTPS 地址，首次推送需輸入 Gitee 賬號密碼。
若使用 SSH 地址但未配置密鑰，需先生成SSH密鑰并添加到 Gitee 賬戶（若失敗重新進行步驟5）。

4. 驗證提交結果

1.打開 Gitee 倉庫頁面，刷新后應看到項目文件已上傳。
2.后續代碼修改后，重復以下流程：

git add .
git commit -m "提交描述"
git push

5.常見問題

5.1 SSH 連接失敗：
檢查 SSH 密鑰是否已添加到 Gitee 賬戶。
測試連接：ssh -T git@gitee.com，顯示 Welcome to Gitee.com! 表示成功。
5.2 推送沖突：
若遠程倉庫已有文件（如初始化時勾選了README），先執行：

git pull origin master --allow-unrelated-histories
git push -u origin master

5.3 倉庫地址錯誤：
修改遠程地址：git remote set-url origin 新地址
5.4 SSH配置不成功，權限被拒絕

一、生成 SSH 密鑰對
1.打開終端（Windows 用戶使用 Git Bash）。
2.執行命令生成密鑰（替換為你的 Gitee 郵箱）：

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

提示保存路徑時，直接按回車使用默認路徑（~/.ssh/id_ed25519）。
若提示輸入密碼（passphrase），可留空直接回車（或設置一個易記的密碼）。
3.查看生成的公鑰：

cat ~/.ssh/id_ed25519.pub

復制輸出的全部內容（以 ssh-ed25519 開頭，包含郵箱的字符串）。
二、將公鑰添加到 Gitee 賬戶
1.登錄 Gitee，點擊右上角頭像 → 「設置」 → 「SSH 公鑰」。
2.填寫信息：
標題：自定義（如 My PC）
公鑰：粘貼復制的 id_ed25519.pub 內容
3.點擊 「確定」 完成添加。
三、測試 SSH 連接
1.終端執行連接測試：

ssh -T git@gitee.com

首次連接會提示是否信任主機，輸入 yes 回車。
成功響應：Welcome to Gitee.com, YourUsername!
2.若仍失敗：
檢查公鑰是否完整粘貼（開頭結尾無多余空格）。
確保執行 ssh-add 加載私鑰：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

四、檢查遠程倉庫地址
1.確認遠程倉庫地址是否為 SSH 格式：

git remote -v

正確格式：git@gitee.com:用戶名/倉庫名.git
錯誤格式：https://gitee.com/用戶名/倉庫名.git（HTTPS 地址需賬號密碼，與 SSH 無關）
2.若地址錯誤，修改為 SSH 地址：

git remote set-url origin git@gitee.com:用戶名/倉庫名.git

五、重新推送代碼
再次執行推送命令：

git push -u origin master

📌 其他可能的問題
1.文件權限問題（Linux/macOS）

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519

2.多個密鑰沖突：
若已存在其他密鑰（如 id_rsa），需在 ~/.ssh/config 中指定密鑰：

Host gitee.comHostName gitee.comIdentityFile ~/.ssh/id_ed25519

3.防火墻或代理限制：
確保端口 22 未被封鎖（企業網絡可能限制 SSH）。

完成以上步驟后，即可正常推送代碼到 Gitee 倉庫。