DEV Community

codemee
codemee

Posted on

在 micro 編輯器中安裝與設定 Catppuccin 配色

#microeditor #themes

本文由 ChatGPT 生成

micro 是一款操作方式直覺的終端機文字編輯器，支援自訂配色與 True Color。本文說明如何在已經安裝 Git 的前提下，從 Catppuccin 官方儲存庫安裝配色主題，並設定為 micro 的預設配色。

Catppuccin 提供哪些配色？

Catppuccin 為 micro 提供四種主要風格：

配色 類型 特性
latte 淺色 適合淺色終端機與明亮環境
frappe 深色 色調柔和，整體亮度較高
macchiato 深色 明暗均衡，適合長時間使用
mocha 深色 背景最深，對比鮮明

每種配色另外提供 -transparent 版本。透明版本不指定編輯區背景色，會沿用 Windows Terminal、WezTerm 等終端機本身的背景、壓克力或透明效果。

如果使用淺色 Windows Terminal，可以先選擇 catppuccin-latte；深色介面則建議從 catppuccin-macchiato 或 catppuccin-mocha 開始嘗試。

Windows：使用 PowerShell 安裝

1. 建立 micro 配色目錄

開啟 PowerShell，執行：

$configDir = Join-Path $HOME ".config\micro"
$themeDir = Join-Path $configDir "colorschemes"
$repoDir = Join-Path $configDir "catppuccin"

New-Item -ItemType Directory -Force $themeDir | Out-Null
Enter fullscreen mode Exit fullscreen mode

micro 預設會從下列目錄讀取自訂配色：

C:\Users\你的使用者名稱\.config\micro\colorschemes
Enter fullscreen mode Exit fullscreen mode

2. Clone Catppuccin 官方儲存庫 

git clone https://github.com/catppuccin/micro.git $repoDir
Enter fullscreen mode Exit fullscreen mode

儲存庫會下載到：

C:\Users\你的使用者名稱\.config\micro\catppuccin
Enter fullscreen mode Exit fullscreen mode

3. 複製配色檔 

Copy-Item "$repoDir\themes\*.micro" $themeDir -Force
Enter fullscreen mode Exit fullscreen mode

完成後，colorschemes 目錄應包含：

catppuccin-latte.micro
catppuccin-frappe.micro
catppuccin-macchiato.micro
catppuccin-mocha.micro
catppuccin-latte-transparent.micro
catppuccin-frappe-transparent.micro
catppuccin-macchiato-transparent.micro
catppuccin-mocha-transparent.micro
Enter fullscreen mode Exit fullscreen mode

Linux／macOS：使用終端機安裝

先建立目錄並 Clone 官方儲存庫：

mkdir -p ~/.config/micro/colorschemes

git clone \
  https://github.com/catppuccin/micro.git \
  ~/.config/micro/catppuccin
Enter fullscreen mode Exit fullscreen mode

接著複製所有配色檔：

cp ~/.config/micro/catppuccin/themes/*.micro \
   ~/.config/micro/colorschemes/
Enter fullscreen mode Exit fullscreen mode

在 micro 中啟用配色

安裝完成後啟動 micro：

micro
Enter fullscreen mode Exit fullscreen mode

按下 Ctrl+E 開啟 micro 命令列，先強制啟用 True Color：

set truecolor on
Enter fullscreen mode Exit fullscreen mode

接著選擇配色。例如使用淺色 Latte：

set colorscheme catppuccin-latte
Enter fullscreen mode Exit fullscreen mode

其他深色版本可以使用：

set colorscheme catppuccin-frappe
set colorscheme catppuccin-macchiato
set colorscheme catppuccin-mocha
Enter fullscreen mode Exit fullscreen mode

若要使用終端機本身的背景效果，請選擇透明版本，例如：

set colorscheme catppuccin-mocha-transparent
Enter fullscreen mode Exit fullscreen mode

主題名稱不需要加上 .micro 副檔名。使用 set 指令後，micro 會把選項保存在設定檔中，下次開啟仍會繼續使用。

更新 Catppuccin 主題

由於安裝時保留了 Git 儲存庫，之後可以直接取得官方更新。

Windows PowerShell 

$repoDir = Join-Path $HOME ".config\micro\catppuccin"
$themeDir = Join-Path $HOME ".config\micro\colorschemes"

git -C $repoDir pull
Copy-Item "$repoDir\themes\*.micro" $themeDir -Force
Enter fullscreen mode Exit fullscreen mode

Linux／macOS 

git -C ~/.config/micro/catppuccin pull

cp ~/.config/micro/catppuccin/themes/*.micro \
   ~/.config/micro/colorschemes/
Enter fullscreen mode Exit fullscreen mode

執行 git pull 後仍需再次複製配色檔，才能把儲存庫內的最新版本同步到 micro 的 colorschemes 目錄。

確認 micro 設定

micro 的設定通常存放在：

~/.config/micro/settings.json
Enter fullscreen mode Exit fullscreen mode

Windows 通常對應至：

C:\Users\你的使用者名稱\.config\micro\settings.json
Enter fullscreen mode Exit fullscreen mode

設定內容應包含類似以下欄位：

{
    "colorscheme": "catppuccin-latte",
    "truecolor": "on"
}
Enter fullscreen mode Exit fullscreen mode

如果設定檔原本已有其他選項，不要用以上範例覆蓋整份檔案。直接在 micro 中執行 set 指令是較安全的做法。

常見問題

顯示 colorscheme not found

確認 .micro 檔案位於正確目錄：

~/.config/micro/colorschemes
Enter fullscreen mode Exit fullscreen mode

Windows 也要確認檔案沒有被誤存為：

catppuccin-latte.micro.txt
Enter fullscreen mode Exit fullscreen mode

如果曾經設定 MICRO_CONFIG_HOME 或 XDG_CONFIG_HOME 環境變數，micro 的實際設定目錄可能不在預設位置。

顏色失真或看起來很灰

Catppuccin 使用 RGB True Color。請在 micro 中按下 Ctrl+E，執行：

set truecolor on
Enter fullscreen mode Exit fullscreen mode

現代終端機通常支援 True Color，但有時 micro 無法從環境變數正確判斷，手動開啟可以避免顏色被近似成 256 色。

透明版本沒有透明效果

透明版本只代表主題不自行指定主要背景色；透明度、背景圖或壓克力效果仍需在 Windows Terminal、WezTerm 或其他終端機中設定。

再次執行 git clone 時出現目錄已存在

這代表 Catppuccin 儲存庫可能已經安裝，不需要重新 Clone。改用更新指令即可：

git -C "$HOME\.config\micro\catppuccin" pull
Enter fullscreen mode Exit fullscreen mode

參考資料

Top comments (0)