腳本編寫
工具

git

使用 Git 追蹤插件的變更、回滾錯誤以及跨機器共享程式碼。

為什麼要組織你的程式碼？

一旦您擁有多個腳本，一致的資料夾結構可以節省時間並使版本控制變得簡單。

設定程式碼資料夾結構

組織專案最簡單的方法之一是在本機電腦上建立專用的程式碼資料夾。在此資料夾中，您可以為每個專案或儲存庫建立子資料夾。以下是推薦的資料夾結構：

/home/your-username/code/
  ├── project1/
  ├── project2/
  └── project3/

每個子資料夾（例如project1）代表一個儲存庫，您將在其中儲存該項目的檔案和程式碼。

什麼是儲存庫？

儲存庫（或 repo）本質上是一個包含 Git 追蹤內容的資料夾。當您在本機建立儲存庫時，您可以在該資料夾中初始化 Git，從而允許您將任何變更儲存到線上複製。

本機和遠端儲存庫

  • 本機儲存庫：這是儲存在您的電腦上的專案資料夾之一中的儲存庫。
  • 遠端儲存庫：線上儲存的儲存庫版本（例​​如，在 GitLab 或 GitHub 上）。

使用 Git 和 GitHub

一旦您的資料夾結構就位，您就可以初始化 Git 並將本機專案連接到 GitHub。請依照以下步驟開始：

使用 Git 和 GitHub 的基本步驟

  1. 安裝Git
  2. 建立 GitHub 帳戶
  3. 在 GitHub 上建立一個空白儲存庫
  4. 在本機專案中初始化 Git
  5. 將本機儲存庫連接到 GitHub
  6. 暫存您的文件
  7. 提交您的更改
  8. 將您的變更推送到 GitHub
  9. 線上查看您的儲存庫

1.安裝Git

如果您尚未安裝 Git，可以使用以下命令在 Linux 上安裝：

sudo apt install git

2. 建立 GitHub 帳戶

如果您還沒有帳戶，請造訪 GitHub 進行註冊。註冊後，您可以在 GitHub 上建立儲存庫來線上儲存您的程式碼。

3. 在 GitHub 上建立一個空白儲存庫

  1. 登入GitHub：前往GitHub並登入您的帳戶。
  2. 建立新儲存庫：
    • 點擊右上角的 + 圖標，然後選擇 新儲存庫。
    • 輸入儲存庫名稱（例如your-repository）。
    • 如果需要，請新增描述。
    • 選擇公開或私人可見。
    • 不要使用自述文件、.gitignore 或許可證初始化儲存庫（以避免衝突）。
    • 點選建立儲存庫。

4. 在本機專案中初始化 Git

若要開始使用 Git 追蹤專案資料夾，請開啟終端，導航至專案資料夾，然後執行：

cd code/your/project/folder
git init

此指令會在專案資料夾中初始化一個空的 Git 儲存庫。

5. 將本機儲存庫連接到 GitHub

接下來，您需要將本機儲存庫連接到 GitHub。在 GitHub 上建立空白儲存庫後，將其作為遠端儲存庫新增至本機專案：

cd code/your/project/folder
git remote add origin https://github.com/your-username/your-repository.git

將 your-username 和 your-repository 替換為您的實際 GitHub 使用者名稱和儲存庫名稱。此命令將您的本機專案與 GitHub 上的遠端儲存庫連結。

6. 暫存您的文件

在將變更儲存到 Git 之前，您需要告訴 Git 您已變更並想要儲存哪些檔案。這稱為「暫存」您的文件。使用以下命令暫存所有已修改或新檔案：

git add .
```這告訴 Git 追蹤您對專案中所有文件所做的更改。您也可以將 `.` 替換為檔案名稱來暫存特定檔案。

### 7. 提交您的更改

暫存後，下一步是將變更儲存（或「提交」）到本機 Git 儲存庫。提交時，您應該始終包含一條訊息來描述您所做的更改。例如：

```sh
git commit -m "Add new feature"

-m 標誌可讓您編寫一條訊息來總結您所做的更改。此訊息可協助您和其他人了解此提交中修改的內容。

8. 將您的變更推送到 GitHub

在本機提交變更後，您現在可以將它們「推送」到 GitHub，以便更新您的遠端儲存庫。執行以下命令來上傳您的變更：

git push -u origin main

main 分支是 GitHub 中儲存程式碼的預設分支，此命令會將本機變更上傳到遠端儲存庫，以便在線上存取它們。

9. 在 GitHub 上查看您的程式碼

將程式碼推送到 GitHub 後，您可以在 GitHub Web 介面中查看您的儲存庫。您應該會看到本機儲存庫中的文件，以及顯示您所做變更的提交歷史記錄。

結論

透過將程式碼組織到專用資料夾中並使用 GitHub 管理和備份儲存庫，您將保持專案結構良好且易於存取。獲得程式碼的工作版本後，將其推送到 GitHub。然後，您可以使用 GitHub Web 介面或 Visual Studio Code 輕鬆追蹤任何更改，它會突出顯示已修改的行。這種方法可讓您繼續完善和擴展程式碼，而不會遺失進度或變更的追蹤。

Git 以及 GitHub 和 GitLab 等平台都是強大的工具，雖然它們可能很複雜，但網路上有大量資源可以幫助您更好地理解它們。我發現的最有價值的資源之一是像 ChatGPT 這樣的人工智慧助理。您可以描述需要完成的任務，這些工具將耐心地引導您逐步完成流程。

術語表

以下是使用 Git 和 GitHub 時會遇到的一些常見術語：- 提交：在儲存庫中更改的快照。每次提交都包含一條訊息，描述更改的內容，並建立歷史記錄，供您稍後參考或恢復。

  • 儲存庫（Repo）：Git 追蹤的檔案及其歷史記錄的集合。儲存庫可以存在於您的電腦本機，也可以遠端存在於 GitHub 等平台上。每個項目通常存儲在其自己的存儲庫中。
  • 遠端：遠端儲存庫是託管在 GitHub 等平台上的專案版本。電腦上專案的本機版本連結到此遠端版本，以便您可以上傳（推送）和下載（拉取）變更。
  • 暫存：準備提交文件的流程。當您暫存文件時，您是在告訴 Git 您希望將其包含在下一次提交中。暫存允許您選擇要在提交中包含哪些變更。
  • 推送：將提交的變更從本機儲存庫傳送到遠端儲存庫（例如 GitHub）的行為，以便其他人可以存取程式碼的更新版本。
  • 拉：從遠端儲存庫取得變更以更新本機副本的行為。當您想要將本機儲存庫與遠端的最新版本同步時，您可以提取變更。
  • Origin：首次將本機儲存庫連接到遠端時遠端儲存庫的預設名稱。通常指 GitHub 上專案的主 URL。
AI輔助開發視覺工作室程式碼