1. 下載 Toolkit

在 Mac 上安裝 GNU sed 並複製 Ayakaleaf Toolkit。

1. 檢查 Git 與 Homebrew

   git --version
   brew --version
   

   若執行 Git 時 macOS 要求您安裝 Command Line Tools，請先安裝它們。若尚未安裝 Homebrew，請依照官方說明安裝。

2. 將 GNU sed 加入 PATH

   Toolkit 指令碼會使用 macOS 內建的 BSD sed 會拒絕的 GNU sed 選項。請安裝 GNU sed，並在此終端機中將它放在 PATH 的最前面：

   brew install gnu-sed
   export PATH="$(brew --prefix gnu-sed)/libexec/gnubin:$PATH"
   sed --version
   

   最後一個指令應該會印出 GNU sed。

   像 alias sed=gsed 這樣的別名是不夠的：Toolkit 執行的是 Bash 指令碼，它們看不到您互動式 shell 中的別名。您不需要取代 /usr/bin/sed。

   在每個用來執行 Toolkit 的新終端機中，請再次執行 export PATH=... 這一行，或將它加入您的 shell 啟動檔案中，並放在 Homebrew 本身的初始化之後。

3. 複製 Ayakaleaf Toolkit 儲存庫

   請選擇一個會持續保留的目錄。對於線上資料庫與專案資料，請避免使用 /tmp、卸除式磁碟機，以及 iCloud Drive 等雲端同步資料夾。本指南使用 ~/ayakaleaf-toolkit：

   git clone https://github.com/ayaka-notes/toolkit.git "$HOME/ayakaleaf-toolkit"
   cd "$HOME/ayakaleaf-toolkit"
   

   若該目錄中已有安裝，請直接使用它，或為新執行個體選擇另一個目錄。請勿在既有部署上初始化新的設定。

​

下一步

請繼續進行 2. 熟悉 Toolkit。