介紹

本週，我加深了對 Git 的理解，特別是使用 Git 遙控器。作為先決條件，在處理遠端時熟悉 Git 合併至關重要。上週，我分享了我第一次使用 Git merge 的經驗並討論了一些最佳實踐。本週，我在開發新功能時應用了這些知識，不是在我自己的儲存庫中，而是在合作者的儲存庫（我朋友 Mayank 的）中。同時，他在我的儲存庫中開發了一項功能，使我們能夠使用 Git 練習遠端協作。

新功能：支援TOML配置

目前，我過去幾週開發的工具使用溫度和模型等選項的預設值集，當使用者不提供特定參數時會套用這些值。此新功能的目標是透過新增從使用者主目錄中的 TOML 檔案讀取組態設定的支援來擴充該工具的功能。

例如，如果使用者在 C:\User\Anh\config.toml 中有一個設定文件，該工具現在將檢查使用者主目錄中是否存在 .toml 檔案。如果存在此類文件，該工具將讀取該文件並應用其值來設定預設配置，從而覆蓋內建預設值。但是，使用者仍然可以提供命令列參數，該參數將優先於 TOML 檔案值。

執行

為了實現這個功能，我利用了toml套件來解析TOML設定檔的內容：

import * as toml from 'toml';

由於該工具將在用戶的主目錄中搜尋 .toml 文件，因此我使用 Node.js 的內建 os 模組來檢索主目錄路徑：

const os = require("os");
const homeDir = os.homedir();

從使用者的主目錄收集所有檔案後，我迭代它們以查找以 .toml 結尾的隱藏檔案（以點 . 開頭的檔案）。找到的第一個 .toml 檔案被用作該工具的配置來源。

筆記

• 該工具將在主目錄中尋找隱藏的「點檔案」（例如 .config.toml），其中包含 TOML 格式的預設選項。
• 如果檔案遺失，工具將忽略此檔案並繼續使用 config.js 檔案中的預設設定。
• 如果文件存在但不是有效的 TOML，該工具將退出並顯示相應的錯誤訊息。
• 如果 TOML 檔案存在且沒有命令列參數覆蓋其值，則將使用 TOML 檔案中的設定（例如預設模型）。
• 該工具將忽略 TOML 檔案中任何無法識別的選項，以確保向後相容性。

遠端協作流程

如前所述，本週涉及練習 Git 遠距工作流程以及 Git 與 Mayank 合併。為了開發他的儲存庫中的功能，我按照以下步驟操作：

1. 分叉和克隆：我分叉了他的存儲庫並將其克隆到我的本地計算機。
2. 建立分支：我在本地副本中建立了一個新分支並開始研究新功能。
3. 提交和推送：進行更改後，我將它們提交到分支並將分支推送到我的分叉存儲庫。

 git push origin 

一旦 Mayank 將他的變更推送到新分支並要求拉取請求 (PR)，我想在合併之前測試他的程式碼。這就是 git Remote 變得至關重要的地方：

• 新增遠端：我將他的儲存庫作為遠端新增至我的本機電腦：

  git remote add  

• 獲取提交：我從他的存儲庫中獲取了最新的提交和分支：

git fetch 

• 追蹤分支：我創建了一個追蹤分支來追蹤他的更新，而不直接影響我的儲存庫：

git checkout -b  /

錯誤識別和解決

在測試過程中，我發現了 Mayank 分支中的兩個關鍵問題：

• 目錄設定錯誤：該工具錯誤地從專案根目錄而非使用者的主目錄讀取 TOML 檔案。
• 路徑解析：程式碼使用相對檔案路徑，當我在我的機器上運行它時導致錯誤。我建議切換到絕對路徑

// Resolve the path to the configuration file
const configPath = path.resolve(__dirname, "../.toml");

// Load configuration from config.toml
const config = loadConfig(configPath);

確定這些問題後，我透過 Slack 與 Mayank 進行了討論，並合作尋找解決方案。我還直接就他的拉取請求提供了回饋。這個過程讓我感覺自己正在為一個現實世界的協作專案做出貢獻。一旦我對修復感到滿意，我將他的分支合併到主分支並將其推送到我的遠端儲存庫。

結論

使用 Git 遠距和合併的過程非常具有教育意義。我現在對在共享程式碼庫上進行協作更有信心了。以前，我經常會因為不同開發人員的多次提交和貢獻而感到不知所措，但現在我對 Git 工作流程有了更好的控制和理解。

透過研究此功能並整合 Git 遙控器，我獲得了實務經驗，這對於未來的專案來說是非常寶貴的。