如何在 PyCharm 中將程式碼推送到 GitLab

在 PyCharm 中將程式碼推送到 GitLab，你可以依照以下完整流程進行。如果你已經有一個 GitLab 儲存庫（repository），流程會很順暢；若還沒，也會教你怎麼建立並綁定。

✅ 基本前提

• ✅ 你已安裝好 PyCharm（建議 Professional，但 Community 也可）
• ✅ 你已在 GitLab.com 上擁有帳號
• ✅ 已建立 GitLab 專案或打算新建一個
• ✅ 本機安裝了 Git（PyCharm 會自動偵測）

🧭 流程總覽：

1. 新增或載入你的 PyCharm 專案
2. 初始化 Git（若尚未）
3. 新增遠端 GitLab 專案連結
4. 提交（commit）本地變更
5. 推送（push）到 GitLab
6. 可選：設定 SSH Key 或 Token 做安全連接

🧩 Step-by-Step 教學

🚀 Step 1：初始化 Git（如尚未）

1. 開啟你的 PyCharm 專案
2. 點選上方選單：VCS > Enable Version Control Integration
3. 選擇 Git，按下「OK」

✅ 完成後，PyCharm 會將專案資料夾變為 Git 倉庫，出現 .git 資料夾

🌐 Step 2：將本地專案連結到 GitLab

📌 方法一：你已在 GitLab 建立專案

1. 前往 GitLab 專案頁 → 點選 Clone → 複製 HTTPS 或 SSH 連結

   範例：

   https://gitlab.com/username/myproject.git
   

2. 回到 PyCharm
   • 開啟 Terminal（底部工具欄）
   • 執行：

     git remote add origin https://gitlab.com/username/myproject.git
     

✅ Step 3：提交你的變更（Commit）

1. 選單：VCS > Commit...
2. 選取變更檔案，輸入 Commit 訊息
3. 點擊「Commit」或「Commit and Push」

☁️ Step 4：推送（Push）到 GitLab

1. 若剛才沒有 Push，可以選擇：
   • VCS > Git > Push
2. 選擇要推送的分支（預設為 main 或 master）
3. 點「Push」

✅ 第一次推送會建立遠端分支

🔐 Step 5：設定憑證（若出現權限錯誤）

方法一：使用 GitLab Personal Access Token（建議）

1. 前往 GitLab：User Settings > Access Tokens
2. 建立 Token，勾選至少以下權限：
   • read_repository
   • write_repository
3. 在 PyCharm 彈出登入畫面時，用：
   • Username：你的 GitLab 使用者名稱
   • Password：你剛建立的 Access Token

方法二：使用 SSH 金鑰（安全性更高）

1. 在 Terminal 執行：

   ssh-keygen -t ed25519 -C "[email protected]"
   

2. 加入 SSH 公鑰到 GitLab：
   • GitLab > User Settings > SSH Keys
   • 貼上 ~/.ssh/id_ed25519.pub 的內容
3. 修改 Git 遠端 URL 為 SSH：

   git remote set-url origin [email protected]:username/myproject.git
   

🔄 常用 Git 操作（在 PyCharm）

🧪 測試是否成功

1. 推送後，回到 GitLab 頁面
2. 應該可以看到你的程式碼已上傳
3. 若專案為公開，你可分享 clone URL 給他人

❓常見錯誤排查