模組五：Hyprland 配置 on Tarragon

Hyprland 安裝與環境建置

Mon, 29 Jun 2026 00:00:00 +0000

Hyprland 的安裝分三層：compositor（負責視窗管理與畫面合成的核心程式，詳見 Wayland 顯示協議）本身、GPU 驅動、桌面配套工具。Compositor 只管視窗排列和畫面輸出，其餘功能（status bar、launcher、通知、音訊、藍牙、網路）都需要另外裝。本篇以 Arch Linux 為主要說明對象，其他發行版在最後簡述。

核心套件

1sudo pacman -S hyprland xorg-xwayland xdg-desktop-portal-hyprland

套件	角色
`hyprland`	Compositor 本體，在 Arch 官方 `extra` repo，不需要 AUR
`xorg-xwayland`	X11 相容層，讓舊 X11 應用程式在 Wayland 環境裡正常運行
`xdg-desktop-portal-hyprland`	Hyprland 專屬的 portal backend，處理 screen sharing 和檔案對話框

[VM 可測試] 套件安裝本身在 VM 和實機上完全相同。

GPU 驅動

GPU 驅動決定 Hyprland 的渲染是走硬體加速還是軟體 fallback。AMD 和 Intel 開箱即用，NVIDIA 需要額外配置。

AMD（推薦，開箱即用）

1sudo pacman -S mesa vulkan-radeon libva-mesa-driver mesa-vdpau

mkinitcpio MODULES 加入：amdgpu

環境變數（放在 Hyprland 配置裡）：

1env = {
2    "LIBVA_DRIVER_NAME, radeonsi",
3    "VDPAU_DRIVER, radeonsi",
4    "AMD_VULKAN_ICD, RADV",
5}

AMD 是 Hyprland / Wayland 生態支援最好的 GPU。如果是新購硬體、有選擇的餘地，AMD 是最省事的選項。

Intel（開箱即用）

1sudo pacman -S mesa vulkan-intel intel-media-driver

mkinitcpio MODULES 加入：i915

1env = {
2    "LIBVA_DRIVER_NAME, iHD",
3    "VDPAU_DRIVER, va_gl",
4}

Intel 內顯在 Wayland 上表現穩定，適合筆電和輕度桌面使用。

NVIDIA（需要額外配置，非官方支援）

[需實機測試] NVIDIA 的所有設定在 VM 中無意義——VM 使用 virtio-gpu 或軟體渲染，不走 NVIDIA 驅動。以下步驟只在實體機有 NVIDIA 顯卡時才需要。

Hyprland 官方不支援 NVIDIA，但社群有成熟的 workaround。最低版本需求：

NVIDIA driver >= 555（555 引入完整 GBM 支援和 explicit sync，是 Wayland 硬體渲染的最低依賴。535 系列有 explicit sync 問題，Wayland 下容易 flicker。590+ 修復多數 HDR 和多螢幕邊界問題）
xorg-xwayland >= 24.1
wayland-protocols >= 1.34

安裝：

1sudo pacman -S nvidia-dkms nvidia-utils libva-nvidia-driver
2# 32-bit 支援（遊戲可能需要）：
3sudo pacman -S lib32-nvidia-utils

mkinitcpio MODULES（依硬體配置選擇）：

純 NVIDIA 桌機：

1MODULES=(nvidia nvidia_modeset nvidia_uvm nvidia_drm)

Intel + NVIDIA hybrid 筆電（Intel 排在 NVIDIA 前面）：

1MODULES=(i915 nvidia nvidia_modeset nvidia_uvm nvidia_drm)

更新 initramfs：

1sudo mkinitcpio -P

Modprobe 設定：

1# /etc/modprobe.d/nvidia.conf
2options nvidia_drm modeset=1

GRUB kernel parameter：

1# /etc/default/grub
2GRUB_CMDLINE_LINUX_DEFAULT="... nvidia_drm.modeset=1 nvidia_drm.fbdev=1"

更新 GRUB：

1sudo grub-mkconfig -o /boot/grub/grub.cfg

Hyprland 配置裡的 NVIDIA 環境變數：

1env = {
2    "LIBVA_DRIVER_NAME, nvidia",
3    "__GLX_VENDOR_LIBRARY_NAME, nvidia",
4    "GBM_BACKEND, nvidia-drm",         -- 如果 Firefox crash，移除這行
5    "NVD_BACKEND, direct",
6}

Cursor 修正（NVIDIA 常見的硬體 cursor 問題）：

1hl.config({
2    cursor = {
3        no_hardware_cursors = true,
4        allow_dumb_copy = true,
5    },
6})

Suspend/resume 支援：

1sudo systemctl enable nvidia-suspend.service nvidia-hibernate.service nvidia-resume.service

檢查 GPU 驅動狀態

1lspci -k | grep -A 3 VGA        # 查看使用中的驅動
2glxinfo | grep "OpenGL renderer" # 查看活躍的 renderer
3vulkaninfo --summary             # Vulkan 裝置資訊

GPU 驅動相關的故障診斷（driver hang、畫面凍結、suspend/resume 後異常）見桌面環境維護與故障排除。

桌面配套套件

Hyprland 只管視窗，以下是一個可用桌面需要的配套工具：

 1sudo pacman -S \
 2  kitty waybar wofi mako \
 3  polkit-gnome grim slurp wl-clipboard cliphist \
 4  hyprpaper hyprlock hypridle \
 5  pipewire pipewire-alsa pipewire-jack pipewire-pulse wireplumber \
 6  pamixer pavucontrol brightnessctl \
 7  bluez bluez-utils blueman \
 8  networkmanager network-manager-applet \
 9  thunar gvfs \
10  qt5-wayland qt6-wayland \
11  ttf-meslo-nerd noto-fonts noto-fonts-cjk

類別	套件	用途
終端機	`kitty`	Hyprland 預設配置使用的 terminal emulator
狀態列	`waybar`	JSON config + CSS styling 的 status bar
啟動器	`wofi`	Wayland 原生 app launcher
通知	`mako`	輕量 notification daemon
認證代理	`polkit-gnome`	GUI 權限提升（sudo 對話框）
截圖	`grim` + `slurp`	截圖工具 + 選區工具
剪貼簿	`wl-clipboard` + `cliphist`	剪貼簿存取 + 歷史記錄
桌布	`hyprpaper`	靜態桌布
鎖屏	`hyprlock`	Hyprland 配套鎖屏
Idle	`hypridle`	閒置偵測（觸發鎖屏/休眠）
音訊	`pipewire` + `wireplumber` + `pipewire-pulse`	音訊 server（取代 PulseAudio）
音量控制	`pamixer`（CLI）+ `pavucontrol`（GUI）	音量調整
亮度	`brightnessctl`	螢幕亮度（筆電）
藍牙	`bluez` + `bluez-utils` + `blueman`	藍牙協定 + GUI 管理
網路	`networkmanager` + `nm-applet`	網路管理 + system tray 圖示
檔案管理	`thunar` + `gvfs`	圖形檔案管理器 + 回收筒/遠端掛載
Qt 相容	`qt5-wayland` + `qt6-wayland`	Qt 應用在 Wayland 下正常運行
字型	`ttf-meslo-nerd` + `noto-fonts-cjk`	Nerd Font（waybar icon 需要）+ CJK 字型

AUR 補充套件（用 yay 或 paru）：

1yay -S grimblast-git   # Hyprland 截圖 wrapper
2yay -S swww            # 動態桌布（hyprpaper 的替代）
3yay -S rofi-wayland    # 功能比 wofi 更豐富的 launcher

[已驗證] 套件安裝在 VM 中完全可執行。waybar、wofi、mako、hyprlock 在 virtio-gpu-gl-pci 加速下正常 render（Hyprland 0.55 + UTM 4.7.5 實測）。

[需實機測試] 藍牙（bluez）、亮度（brightnessctl）、音訊裝置偵測（pipewire）需要實際硬體。

登入管理器

Hyprland 預設不含登入管理器。三個選項：

從 TTY 直接啟動（最簡單）

登入文字介面後直接執行 Hyprland。建議用 wrapper script 設定必要的環境變數：

1#!/bin/sh
2# ~/start-hyprland.sh
3export XDG_SESSION_TYPE=wayland
4export XDG_CURRENT_DESKTOP=Hyprland
5export XDG_SESSION_DESKTOP=Hyprland
6exec Hyprland

1chmod +x ~/start-hyprland.sh
2~/start-hyprland.sh

greetd + tuigreet（推薦）

greetd 是一個輕量的登入管理器，tuigreet 是它的 TUI 前端：

1sudo pacman -S greetd greetd-tuigreet

設定 /etc/greetd/config.toml：

1[terminal]
2vt = 1
3
4[default_session]
5command = "tuigreet --cmd Hyprland"
6user = "greeter"

自動登入（可選）：

1[initial_session]
2command = "Hyprland"
3user = "yourusername"

啟用服務：

1sudo systemctl enable greetd

SDDM

如果已經有 KDE 或偏好圖形化登入介面：

1sudo pacman -S sddm
2sudo systemctl enable sddm

SDDM 會自動偵測到 Hyprland 並在登入畫面顯示它作為 session 選項。

[VM 可測試] 登入管理器的設定在 VM 中可完整測試。

首次啟動常見問題

症狀	原因	修正
黑屏、沒有 cursor	缺少 polkit agent 或 seatd service	`sudo systemctl enable --now seatd` 或安裝 `polkit-gnome`
開不了 terminal	預設 keybind 用的是 kitty，但 kitty 沒裝	`sudo pacman -S kitty` 或改 keybind 指向已安裝的 terminal
Cursor 不見（NVIDIA）	硬體 cursor 問題	設定 `cursor { no_hardware_cursors = true }`
Portal 衝突，screen share 失敗	同時裝了多個 portal backend	移除 `xdg-desktop-portal-gnome` 和 `xdg-desktop-portal-gtk`
沒有音訊	PipeWire 服務未啟動	`systemctl --user enable --now pipewire wireplumber`
Config 報錯但不影響使用	自動產生的預設 config 語法不完整	emergency keybind 仍可用：SUPER+Q 開 terminal、SUPER+M 離開

配置格式：Lua 取代 hyprlang（v0.55+）

Hyprland v0.55（2026 年 4 月）起，配置格式從 hyprlang（.conf）遷移到 Lua（.lua）。舊的 hyprland.conf 在沒有 .lua 檔案時仍然可用，但 hyprlang 已被標記為 deprecated，預計在後續版本移除。

格式	檔案	狀態
Lua（新）	`~/.config/hypr/hyprland.lua`	推薦
hyprlang（舊）	`~/.config/hypr/hyprland.conf`	deprecated

遷移工具：hyprlang2lua（Go，有瀏覽器版）、hyprconf2lua（Python pip）、hypr-migrate。

本系列後續文章（Hyprland 核心配置、Workspace 與外觀、Caelestia）都使用 Lua 格式。如果在網路上看到 .conf 格式的教學，多數仍然可用，但建議儘早遷移到 Lua。

拆分配置用 Lua 原生的 require()：

1-- hyprland.lua
2require("keybinds")    -- 載入同目錄下的 keybinds.lua
3require("rules")       -- 載入同目錄下的 rules.lua
4require("appearance")

詳細的配置語法和設定邏輯在核心配置和 Workspace、Window Rules 與外觀。

其他發行版

Fedora

Fedora 39 起即在官方 repo。安裝：

1sudo dnf install hyprland

JaKooLit 提供自動化安裝腳本（github.com/JaKooLit/Fedora-Hyprland），Fedora 42+ 運作良好。

NixOS

NixOS 有官方 module，在 configuration.nix 加入：

1programs.hyprland.enable = true;

Home Manager 也有對應 module，可以宣告式管理 Hyprland 配置。

Ubuntu

不推薦。Ubuntu 的 point-release 模型跟 Hyprland 的 bleeding-edge 更新節奏衝突。沒有官方 PPA，從 source 編譯可行但維護成本高。如果一定要用 Debian 系，Arch 的 rolling release 或 Fedora 的半年週期更適合 Hyprland。

安裝後的下一步

安裝完成後，VM 環境的額外設定（環境變數、效能調整、測試矩陣）見 VM 環境設定與測試矩陣。配置檔的組織方式和 keybind 設計見 Hyprland 核心配置。

Hyprland 核心配置

Mon, 29 Jun 2026 00:00:00 +0000

Hyprland v0.55+ 使用 Lua 作為配置語言。Lua 語法基礎見 Lua 腳本語言。

配置檔位置與格式

Hyprland v0.55 起，配置格式從 hyprlang（.conf）遷移到 Lua（.lua）。主配置檔是 ~/.config/hypr/hyprland.lua。如果 .lua 不存在但 .conf 存在，Hyprland 會回退讀取舊格式，但 hyprlang 已標記為棄用，後續版本會移除支援。

修改後即時生效（不需要重新登入或重啟）。第一次啟動時如果沒有配置檔，Hyprland 會自動產生範例配置。即使配置有語法錯誤，緊急快捷鍵（SUPER+Q 開 terminal、SUPER+M 離開）仍然可用。

[VM 可測試] 配置檔格式和載入行為在 VM 裡跟實機完全相同。

模組化拆分

用 Lua 原生的 require() 拆分配置：

1-- ~/.config/hypr/hyprland.lua — 主入口
2
3require("monitors")      -- 載入 monitors.lua
4require("keybinds")      -- 載入 keybinds.lua
5require("rules")         -- 載入 rules.lua
6require("autostart")     -- 載入 autostart.lua
7require("appearance")    -- 載入 appearance.lua
8require("env")           -- 載入 env.lua

require("monitors") 會從同目錄載入 monitors.lua。拆分的理由是職責分離——改 keybind 不用在千行配置裡找位置，每個子檔案可以獨立 diff 和 rollback。

從舊格式遷移

Hyprland 官方提供遷移工具：hyprlang2lua（Go，也有瀏覽器版）和 hypr-migrate。如果你是從零開始，直接用 Lua 格式。

Monitor 設定

Monitor 設定是硬體相關的核心配置，每台機器都不同。

 1-- ~/.config/hypr/monitors.lua
 2
 3hl.config({
 4    monitor = {
 5        -- 語法："name, resolution@refreshrate, position, scale"
 6        "DP-1, 2560x1440@144, 0x0, 1",
 7        "HDMI-A-1, 1920x1080@60, 2560x0, 1",
 8
 9        -- 筆電內建螢幕
10        "eDP-1, preferred, auto, 1.5",
11
12        -- 預設規則（未明確列出的螢幕）
13        ", preferred, auto, 1",
14
15        -- 鏡像模式（DP-2 鏡像 DP-1 的畫面）
16        -- "DP-2, preferred, auto, 1, mirror, DP-1",
17    },
18})

position 決定多螢幕的空間排列——0x0 是左上角原點，2560x0 表示在第一個螢幕的右邊。scale 處理 HiDPI 顯示（1.5 表示 150% 縮放）。

查詢可用的 monitor 名稱：hyprctl monitors

其他選項：

transform, 1 — 旋轉（0=正常、1=90 度、2=180 度、3=270 度）
vrr, 1 — 可變更新率（1=開啟、2=僅全螢幕）
bitdepth, 10 — 10-bit 色彩

筆電合蓋行為

1-- 合蓋時關閉內建螢幕、開蓋時恢復
2-- bindl = 即使輸入鎖定也能觸發（合蓋時需要）
3hl.bindl("", "switch:on:Lid Switch", "exec", "hyprctl keyword monitor 'eDP-1, disable'")
4hl.bindl("", "switch:off:Lid Switch", "exec", "hyprctl keyword monitor 'eDP-1, preferred, auto, 1'")

[需實機測試] Monitor 位置排列、HiDPI 縮放、VRR、旋轉、多螢幕熱插拔、合蓋行為。VM 通常只有一個虛擬螢幕。

Dotfile 管理策略

Monitor 設定是典型的「機器專屬」配置。如果用 chezmoi，可以用 template 依機器名稱切換；如果用 stow，可以把 monitors.lua 排除在 Git 外、每台機器手動寫。

輸入裝置配置

 1-- ~/.config/hypr/hyprland.lua 或拆到獨立檔案
 2
 3hl.config({
 4    input = {
 5        kb_layout = "us",
 6        -- 多語系：kb_layout = "us,de",
 7        -- 切換：kb_options = "grp:alt_shift_toggle",
 8        -- Caps Lock 當 Escape：kb_options = "caps:escape",
 9        kb_options = "",
10
11        follow_mouse = 1,         -- 焦點跟隨滑鼠
12        sensitivity = 0,          -- -1.0 到 1.0（0 = 不修改）
13        accel_profile = "flat",   -- flat 或 adaptive
14
15        repeat_rate = 25,         -- 長按時每秒重複幾次
16        repeat_delay = 600,       -- 按住多久開始重複（毫秒）
17
18        touchpad = {
19            natural_scroll = true,
20            disable_while_typing = true,
21            ["tap-to-click"] = true,
22            drag_lock = false,
23            scroll_factor = 1.0,
24        },
25    },
26})

可用的 XKB options 查詢：/usr/share/X11/xkb/rules/evdev.lst 或 localectl list-x11-keymap-options。

[VM 可測試] 鍵盤 layout、repeat rate。
[需實機測試] 觸控板設定、手勢、滑鼠靈敏度/加速曲線、多鍵盤配置。

Keybind 設計

修飾鍵（Modifier）：`SUPER` 是哪顆鍵

keybind 由「修飾鍵 + 按鍵」組成，Hyprland 配置裡最常當主修飾鍵的是 SUPER。SUPER 是 X11/Wayland 對 Meta 鍵的稱呼，在不同鍵盤上是不同的實體鍵：

PC 鍵盤：Windows 鍵（⊞，通常在 Ctrl 與 Alt 之間）。
Mac 鍵盤：Command 鍵（⌘）。

其他常見修飾鍵：SHIFT、CTRL（Control）、ALT（Mac 上是 Option ⌥）。組合寫法用空格串，例如 "SUPER SHIFT"。選 SUPER 當主修飾鍵是慣例——它幾乎不跟應用程式本身的快捷鍵衝突（應用多用 Ctrl / Alt）。

在 Mac 上跑虛擬機時，實體 ⌘ 會對應到 guest 的 SUPER，但 macOS 會先攔截部分 ⌘ 組合——這層 VM 專屬的坑見 VM 環境設定。

Bind 類型

Hyprland 提供多種 bind 函式，處理不同互動模式：

函式	行為	適用場景
`hl.bind()`	按一次觸發	多數快捷鍵
`hl.binde()`	長按連續觸發	調整視窗大小、音量
`hl.bindm()`	滑鼠綁定	拖曳移動 / 調整視窗
`hl.bindr()`	放開時觸發	切換模式
`hl.bindl()`	輸入鎖定也觸發	合蓋開關、鎖屏時的媒體鍵
`hl.bindel()`	連續 + 鎖定	鎖屏時的音量鍵（長按連續、鎖定可用）

[VM 可測試] 所有 keybind 邏輯和配置語法。

基本操作

 1-- ~/.config/hypr/keybinds.lua
 2
 3-- 基本操作
 4hl.bind("SUPER", "Return", "exec", "kitty")
 5hl.bind("SUPER", "Q", "killactive")
 6hl.bind("SUPER", "D", "exec", "wofi --show drun")
 7hl.bind("SUPER", "F", "fullscreen", "0")
 8hl.bind("SUPER SHIFT", "Space", "togglefloating")
 9
10-- 焦點移動（vim 風格）
11hl.bind("SUPER", "H", "movefocus", "l")
12hl.bind("SUPER", "J", "movefocus", "d")
13hl.bind("SUPER", "K", "movefocus", "u")
14hl.bind("SUPER", "L", "movefocus", "r")
15
16-- 視窗移動
17hl.bind("SUPER SHIFT", "H", "movewindow", "l")
18hl.bind("SUPER SHIFT", "J", "movewindow", "d")
19hl.bind("SUPER SHIFT", "K", "movewindow", "u")
20hl.bind("SUPER SHIFT", "L", "movewindow", "r")
21
22-- 視窗大小調整（長按連續觸發）
23hl.binde("SUPER CTRL", "H", "resizeactive", "-20 0")
24hl.binde("SUPER CTRL", "J", "resizeactive", "0 20")
25hl.binde("SUPER CTRL", "K", "resizeactive", "0 -20")
26hl.binde("SUPER CTRL", "L", "resizeactive", "20 0")
27
28-- 滑鼠綁定：SUPER + 左鍵拖曳移動、右鍵拖曳調整大小
29hl.bindm("SUPER", "mouse:272", "movewindow")
30hl.bindm("SUPER", "mouse:273", "resizewindow")
31
32-- Workspace 切換
33hl.bind("SUPER", "1", "workspace", "1")
34hl.bind("SUPER", "2", "workspace", "2")
35hl.bind("SUPER", "3", "workspace", "3")
36hl.bind("SUPER", "4", "workspace", "4")
37hl.bind("SUPER", "5", "workspace", "5")
38hl.bind("SUPER", "6", "workspace", "6")
39hl.bind("SUPER", "7", "workspace", "7")
40hl.bind("SUPER", "8", "workspace", "8")
41hl.bind("SUPER", "9", "workspace", "9")
42
43-- 把視窗送到指定 workspace
44hl.bind("SUPER SHIFT", "1", "movetoworkspace", "1")
45hl.bind("SUPER SHIFT", "2", "movetoworkspace", "2")
46hl.bind("SUPER SHIFT", "3", "movetoworkspace", "3")
47-- 以此類推
48
49-- 螢幕截圖
50hl.bind("", "Print", "exec", "grimblast copy area")
51hl.bind("SUPER", "Print", "exec", "grimblast copy output")
52
53-- 多螢幕焦點切換
54hl.bind("SUPER", "comma", "focusmonitor", "l")
55hl.bind("SUPER", "period", "focusmonitor", "r")
56hl.bind("SUPER SHIFT", "comma", "movewindow", "mon:l")
57hl.bind("SUPER SHIFT", "period", "movewindow", "mon:r")

設計原則

SUPER（Windows/Command 鍵）當 modifier，避免跟應用程式快捷鍵衝突
方向操作統一用 vim 的 HJKL，降低記憶負擔
modifier 分層：SUPER 是焦點、SUPER+SHIFT 是移動、SUPER+CTRL 是調整大小
常用操作（開 terminal、關視窗、切 workspace）放在最順手的位置

Submap：模態快捷鍵

Submap 類似 vim 的模式切換——進入某個 submap 後，快捷鍵的意義改變，直到離開。適合需要連續操作的場景（如調整大小）：

 1-- 按 SUPER+R 進入 resize 模式
 2hl.bind("SUPER", "R", "submap", "resize")
 3
 4-- 定義 resize 模式的快捷鍵
 5hl.submap("resize")
 6hl.binde("", "H", "resizeactive", "-20 0")
 7hl.binde("", "L", "resizeactive", "20 0")
 8hl.binde("", "K", "resizeactive", "0 -20")
 9hl.binde("", "J", "resizeactive", "0 20")
10hl.bind("", "escape", "submap", "reset")   -- Escape 離開
11hl.submap("reset")

進入 resize 模式後，直接按 HJKL（不需要 modifier）就能持續調整大小，按 Escape 回到正常模式。

媒體鍵與硬體鍵

 1-- 音量（鎖屏時也能用、長按連續觸發）
 2hl.bindel("", "XF86AudioRaiseVolume", "exec", "wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%+")
 3hl.bindel("", "XF86AudioLowerVolume", "exec", "wpctl set-volume @DEFAULT_AUDIO_SINK@ 5%-")
 4hl.bindl("", "XF86AudioMute", "exec", "wpctl set-mute @DEFAULT_AUDIO_SINK@ toggle")
 5hl.bindl("", "XF86AudioMicMute", "exec", "wpctl set-mute @DEFAULT_AUDIO_SOURCE@ toggle")
 6
 7-- 亮度
 8hl.bindel("", "XF86MonBrightnessUp", "exec", "brightnessctl s 10%+")
 9hl.bindel("", "XF86MonBrightnessDown", "exec", "brightnessctl s 10%-")
10
11-- 媒體播放
12hl.bindl("", "XF86AudioPlay", "exec", "playerctl play-pause")
13hl.bindl("", "XF86AudioNext", "exec", "playerctl next")
14hl.bindl("", "XF86AudioPrev", "exec", "playerctl previous")

[需實機測試] 媒體鍵（XF86Audio*）、亮度鍵（XF86MonBrightness*）、合蓋開關——這些依賴實體硬體送出正確的 keycode。VM 鍵盤通常沒有這些鍵。

環境變數

環境變數在 hl.config() 的 env 區段設定，影響 Hyprland 自身和其下執行的應用程式：

 1-- ~/.config/hypr/env.lua
 2
 3hl.config({
 4    env = {
 5        -- 游標主題
 6        "XCURSOR_SIZE, 24",
 7        "XCURSOR_THEME, Bibata-Modern-Classic",
 8        "HYPRCURSOR_SIZE, 24",
 9        "HYPRCURSOR_THEME, Bibata-Modern-Classic",
10
11        -- Qt 應用程式
12        "QT_AUTO_SCREEN_SCALE_FACTOR, 1",
13        "QT_QPA_PLATFORM, wayland;xcb",
14        "QT_QPA_PLATFORMTHEME, qt5ct",
15        "QT_WAYLAND_DISABLE_WINDOWDECORATION, 1",
16
17        -- GTK 應用程式
18        "GDK_BACKEND, wayland,x11,*",
19
20        -- XDG session
21        "XDG_CURRENT_DESKTOP, Hyprland",
22        "XDG_SESSION_TYPE, wayland",
23        "XDG_SESSION_DESKTOP, Hyprland",
24
25        -- Electron 應用程式（VS Code, Discord 等）
26        "ELECTRON_OZONE_PLATFORM_HINT, auto",
27
28        -- Firefox
29        "MOZ_ENABLE_WAYLAND, 1",
30    },
31})

NVIDIA 專用環境變數

如果使用 NVIDIA 顯卡，需要額外設定（AMD 和 Intel 不需要）：

 1-- 只在 NVIDIA 機器上加這些
 2hl.config({
 3    env = {
 4        "LIBVA_DRIVER_NAME, nvidia",
 5        "GBM_BACKEND, nvidia-drm",             -- Firefox 若崩潰就移除這行
 6        "__GLX_VENDOR_LIBRARY_NAME, nvidia",
 7        "NVD_BACKEND, direct",
 8    },
 9    cursor = {
10        no_hardware_cursors = true,             -- NVIDIA 常見的游標問題修正
11        allow_dumb_copy = true,
12    },
13})

[VM 不適用] NVIDIA 環境變數和驅動設定在 VM 裡無意義——VM 使用 virtio-gpu 或軟體渲染。這些設定只在實體 NVIDIA 機器上測試。

VM 專用環境變數

在 VM（UTM/QEMU）裡跑 Hyprland 需要額外的回退設定：

1-- 只在 VM 裡加，實機要移除
2hl.config({
3    env = {
4        "WLR_RENDERER_ALLOW_SOFTWARE, 1",
5        "LIBGL_ALWAYS_SOFTWARE, 1",
6        "WLR_NO_HARDWARE_CURSORS, 1",
7    },
8})

[已驗證] Hyprland 0.55（Aquamarine 渲染後端）+ UTM virtio-gpu-gl-pci 實測：使用 GPU 加速時不需要 WLR_RENDERER 或 LIBGL_ALWAYS_SOFTWARE，Hyprland 自動走 VirGL/Venus 硬體路徑。WLR_NO_HARDWARE_CURSORS 仍需要（virtio-gpu 不支援硬體 cursor）。完整 VM 設定見 VM 環境設定與測試矩陣。

Workspace、Window Rules 與外觀

Mon, 29 Jun 2026 00:00:00 +0000

本篇的配置範例使用 Lua 語法（Hyprland v0.55+）。Lua 基礎見 Lua 腳本語言。

Workspace 設定

Workspace 是平鋪式桌面的空間管理單位。Hyprland 的 workspace 是動態的——不需要預先定義多少個，按了不存在的 workspace 編號就會自動建立。

 1-- 把特定 workspace 綁定到特定螢幕
 2hl.config({
 3    workspace = {
 4        "1, monitor:DP-1, default:true",
 5        "2, monitor:DP-1",
 6        "3, monitor:DP-1",
 7        "7, monitor:HDMI-A-1, default:true",
 8        "8, monitor:HDMI-A-1",
 9        "9, monitor:HDMI-A-1",
10    },
11})

常見的使用模式：

Workspace 1-3 放在主螢幕（寫程式用）
Workspace 7-9 放在副螢幕（瀏覽器、通訊軟體、監控）
用鍵盤瞬間切換（SUPER + 數字鍵），比 alt-tab 在一堆視窗裡找快

Per-workspace layout 覆寫

1hl.config({
2    workspace = {
3        "1, layoutopt:orientation:left",     -- workspace 1 用左側 master
4        "2, layoutopt:orientation:top",      -- workspace 2 用頂部 master
5    },
6})

[VM 可測試] Workspace 切換、綁定邏輯、per-workspace layout。
[需實機測試] Workspace 綁定到特定實體螢幕的行為。

Window Rules

Window rules 讓特定應用程式在開啟時自動套用設定——指定 workspace、強制浮動、設定大小等。

 1hl.config({
 2    windowrule = {
 3        -- 特定 app 自動送到指定 workspace
 4        "workspace 8, class:^(firefox)$",
 5        "workspace 9, class:^(Slack)$",
 6
 7        -- 設定面板、對話框等維持浮動（不進平鋪）
 8        "float, class:^(pavucontrol)$",
 9        "float, class:^(nm-connection-editor)$",
10        "float, title:^(Open File)$",
11        "float, title:^(Save As)$",
12
13        -- Picture-in-picture 浮動 + 置頂 + 固定大小
14        "float, title:^(Picture-in-Picture)$",
15        "pin, title:^(Picture-in-Picture)$",
16        "size 480 270, title:^(Picture-in-Picture)$",
17        "move 100%-490 50, title:^(Picture-in-Picture)$",
18
19        -- 視窗透明度（active inactive）
20        "opacity 0.9, class:^(kitty)$",
21        "opacity 0.85 0.75, class:^(Code)$",
22
23        -- 防止 Electron app 自動最大化
24        "suppressevent maximize, class:.*",
25
26        -- XWayland video bridge（螢幕分享用）
27        "opacity 0.0 override, class:^(xwaylandvideobridge)$",
28        "noanim, class:^(xwaylandvideobridge)$",
29        "noinitialfocus, class:^(xwaylandvideobridge)$",
30        "maxsize 1 1, class:^(xwaylandvideobridge)$",
31        "noblur, class:^(xwaylandvideobridge)$",
32    },
33})

查詢應用程式的 class 和 title

1hyprctl clients          # 列出所有開啟的視窗（含 class、title、PID 等）
2hyprctl activewindow     # 當前焦點視窗的資訊

Window rules 用 regex 匹配 class 和 title。靜態 rules 匹配的是視窗開啟時的初始值（initialTitle / initialClass）。

Window rules 是讓平鋪式桌面「不只是把所有東西硬塞格子」的關鍵——識別哪些 app 適合浮動、哪些適合指定位置，需要累積使用經驗。

[VM 可測試] Window rules 邏輯、workspace 指派、float 規則。查 class/title 也在 VM 裡能做。

Layout 配置

Dwindle

每個新視窗把當前區域一分為二（螺旋式切分），適合不固定視窗數量的工作流：

1hl.config({
2    dwindle = {
3        pseudotile = true,       -- 允許 app 請求 pseudo-tiling（保留原始大小）
4        preserve_split = true,   -- 不自動改變分割方向
5        force_split = 2,         -- 0=跟隨滑鼠, 1=永遠左/上, 2=永遠右/下
6        smart_split = false,
7        smart_resizing = true,
8    },
9})

Master

一個主區域 + 其餘視窗堆疊在側邊，適合「一個主力視窗 + 多個參考視窗」的模式：

1hl.config({
2    master = {
3        new_on_top = false,       -- 新視窗放 master 還是 stack
4        orientation = "left",     -- master 區域位置：left / right / top / bottom / center
5        mfact = 0.55,             -- master 區域佔螢幕的比例
6    },
7})

在 general 裡設定預設 layout：

1hl.config({
2    general = {
3        layout = "dwindle",       -- 或 "master"
4    },
5})

[VM 可測試] Layout 切換和參數調整的行為邏輯。

外觀設定

 1hl.config({
 2    general = {
 3        gaps_in = 5,
 4        gaps_out = 10,
 5        border_size = 2,
 6        ["col.active_border"] = "rgba(89b4faee) rgba(cba6f7ee) 45deg",
 7        ["col.inactive_border"] = "rgba(313244aa)",
 8    },
 9    decoration = {
10        rounding = 8,
11
12        blur = {
13            enabled = true,
14            size = 5,             -- 模糊半徑（越高越模糊、越吃 GPU）
15            passes = 2,           -- 模糊次數（越多越平滑、越重）
16            vibrancy = 0.17,
17            noise = 0.02,
18            new_optimizations = true,
19        },
20
21        shadow = {
22            enabled = true,
23            range = 15,
24            render_power = 3,     -- 1-4，衰減曲線
25            color = "0xee1a1a2e",
26        },
27
28        dim_inactive = false,
29        dim_strength = 0.2,
30
31        active_opacity = 1.0,
32        inactive_opacity = 0.95,
33    },
34})

[需實機測試] blur 的效能影響和視覺品質——這是 Hyprland 最吃 GPU 的功能。VM 裡建議 blur = { enabled = false } 避免卡頓。shadow 和 rounding 在軟體渲染下可以動但會很慢。

動畫設定

 1-- 定義 bezier 曲線
 2hl.animation("bezier", "ease", 0.25, 0.1, 0.25, 1)
 3hl.animation("bezier", "overshot", 0.05, 0.9, 0.1, 1.05)
 4
 5-- Spring 物理動畫（較新的替代方案）
 6hl.animation("spring", "bouncy", 1, 8, 0)   -- damping, frequency, speed
 7
 8-- 套用動畫
 9hl.animation("animation", "windows", 1, 4, "ease", "slide")
10hl.animation("animation", "windowsOut", 1, 4, "ease", "popin 80%")
11hl.animation("animation", "fade", 1, 3, "ease")
12hl.animation("animation", "workspaces", 1, 4, "ease", "slide")
13
14-- 關閉特定動畫
15hl.animation("animation", "windowsMove", 0)

VM 裡跑 Hyprland 時，建議完全關閉動畫以維持可用的操作速度：

1hl.config({
2    animations = {
3        enabled = false,
4    },
5})

[需實機測試] 動畫流暢度是 Hyprland 的核心賣點，只有實機能評估。VM 裡的卡頓是 GPU 加速不足造成的，不代表 Hyprland 本身的效能。

Autostart

 1hl.config({
 2    exec_once = {
 3        -- 桌面元件
 4        "waybar",
 5        "mako",
 6        "hyprpaper",
 7
 8        -- 系統服務
 9        "/usr/lib/polkit-gnome/polkit-gnome-authentication-agent-1",
10        "wl-paste --type text --watch cliphist store",
11
12        -- Idle daemon（閒置鎖屏，鎖屏安全模型見 session-lock 卡）
13        "hypridle",
14    },
15})

exec_once 只在 Hyprland 啟動時跑一次（config reload 不會重複執行）。如果需要每次 reload 都重跑某個指令，用 exec（但多數情況不需要）。

Plugin 系統

Hyprland 用 hyprpm（Hyprland Plugin Manager）管理 plugin：

1hyprpm update                                              # 更新 plugin index
2hyprpm add https://github.com/hyprwm/hyprland-plugins     # 加入官方 plugin repo
3hyprpm enable hyprexpo                                     # 啟用 plugin
4hyprpm disable hyprexpo                                    # 停用 plugin
5hyprpm list                                                # 列出可用 plugin

Plugin	功能
hyprexpo	workspace 鳥瞰（所有 workspace 縮圖一覽）
hy3	i3/sway 風格的手動 tiling layout（替代 dwindle）
hyprspace	類似 macOS Mission Control 的 workspace 切換動畫
hyprbars	視窗標題列（可自訂按鈕）
hyprtrails	游標拖尾特效

Plugin 的配置寫在 hyprland.lua 裡，是 dotfile 的一部分。

[VM 可測試] 不依賴 GPU 的 plugin（hy3、hyprbars）。
[需實機測試] 視覺特效類 plugin（hyprexpo、hyprspace、hyprtrails）。

Dotfile 結構對應

Hyprland 的配置拆成多個 .lua 檔，全部放在同一個 stow package 裡。monitors.lua 是硬體相關的——跨機器搬移時可能要排除或用 template/local 機制處理（見跨平台共用一個 Repo）：

 1~/dotfiles/
 2└── hyprland/
 3    └── .config/
 4        └── hypr/
 5            ├── hyprland.lua       # 主入口（只有 require 行）
 6            ├── monitors.lua       # 硬體相關、可能排除或 template
 7            ├── keybinds.lua
 8            ├── rules.lua
 9            ├── autostart.lua
10            ├── appearance.lua
11            └── env.lua

穩定性與維護的務實面

Hyprland 的開發節奏快、功能更新激進。v0.55 的 Lua 遷移就是一個典型案例——配置格式整個換掉，舊的 .conf 只會再支援一到兩個版本。配置檔的語法和可用選項會隨版本變動。

應對策略：

更新前先看 Hyprland wiki 的 Configuring 頁面和 changelog
dotfile repo 的 commit message 記錄「因應 Hyprland vX.Y 改了什麼設定」
如果用 Arch 的 rolling release，pacman -Syu 前先確認 Hyprland 是否有 breaking change（Arch 社群通常會在論壇預警）
官方提供遷移工具（如 hyprlang2lua），格式變更時優先使用

這是視窗管理與平鋪式工作流提過的代價——把日常桌面建立在高速移動的專案上，持續的配置維護是實際成本。

VM 與實機測試對照

項目	VM 可測試	需實機測試
配置語法 / 結構	可
Keybind 設計	可
Window rules 邏輯	可
Workspace 切換	可
Layout 參數	可
Autostart 順序	可
Plugin 配置	部分	視覺類
動畫流暢度		必要
Blur 效能 / 品質		必要
多螢幕排列		必要
HiDPI 縮放		必要
觸控板 / 手勢		必要
媒體鍵 / 亮度鍵		必要
NVIDIA 驅動設定		必要
螢幕分享		必要
休眠 / 喚醒		必要
合蓋行為		必要

Hyprland VM 環境設定與測試矩陣

Mon, 29 Jun 2026 00:00:00 +0000

VM 是 Hyprland 配置的演練場——用來驗證「配置邏輯對不對」，不是用來體驗「跑起來順不順」。GPU 加速在 VM 中受限，動畫和模糊效果會嚴重降級或無法使用，但配置檔語法、keybind 設計、window rules、workspace 邏輯都能在 VM 中完整測試。

UTM on Apple Silicon 設定

Apple Silicon Mac 用 UTM（基於 QEMU）跑 ARM64 Linux VM：

CPU：UTM 使用 Apple Hypervisor.framework，ARM64 guest 接近原生速度
GPU：使用 virtio-gpu-gl-pci（UTM v4.1+ 新建 Linux VM 的預設）。UTM v5.0.0+ 的 GitHub release 版支援 Venus driver（guest Mesa → host MoltenVK → Apple Metal 的 Vulkan 轉送路徑），這是目前最好的 GPU 加速方案
Linux ISO：Arch Linux ARM（archlinuxarm.org）或 Fedora aarch64
建議配置：4 CPU cores、4GB+ RAM、40GB+ disk

UTM 建 VM 的注意事項

第一頁選 Virtualize，不是 Emulate——同架構（Apple Silicon 跑 ARM64 guest）兩條都是 QEMU，差在 Virtualize 走 hvf 硬體虛擬化（CPU 接近原生）、Emulate 走 TCG 純軟體模擬（CPU 慢一個數量級；實測 C++ 大型編譯一小時只跑 1/3）。Emulate 只在跨架構（ARM Mac 跑 x86_64 guest）才需要。判別現有 VM：guest 裡 lscpu 的 Model name 是 - 為直通、顯示具體型號（如 Cortex-A72）為模擬
選「Linux」虛擬機類型，不是「Other」
Display Card 選 virtio-gpu-gl-pci（有 3D 加速），不是 virtio-gpu-pci（無加速）；Emulate 精靈預設給無加速的 virtio-gpu-pci、Virtualize 精靈通常直接給對
VM 視窗可能停在序列視圖、圖形顯示是另一個視圖——Virtualize 精靈預設多附一個序列裝置，UTM 視窗開機後可能顯示的是序列 console（文字登入、guest 裡 who 顯示登入在 pts/0），跟 virtio-gpu 的圖形輸出是兩個獨立視圖。切換：VM 視窗工具列的顯示器下拉選單 → 選 Display 1 (virtio-gpu)。判讀圖形裝置本身有沒有掛上看 guest 的 ls /dev/dri/（有 card0 = 裝置在、只是視窗看錯視圖）。不想每次切就到 VM 設定移除序列裝置。compositor 要在圖形視圖那側的 VT 上啟動、序列 console 起不了 Hyprland
如果用 App Store 版的 UTM（不含 Venus），只有基本的 virtio-gpu-gl 加速
GitHub release 版的 UTM 支援 Venus/MoltenVK，效能更好但仍不及裸金屬
修飾鍵：Mac 的 ⌘ 對應 guest 的 SUPER，但 macOS 會先攔截部分 ⌘ 組合——Hyprland 的 keybind 幾乎都以 SUPER（Meta）當主修飾鍵（見核心配置的修飾鍵段），而 UTM 裡 Mac 的 Command ⌘ 通常就是那顆 SUPER。問題是 macOS 自己會先吃掉某些 ⌘ 組合（⌘+Q 結束 app、⌘+Space Spotlight…），VM 收不到。判讀：SUPER 綁定沒反應、但焦點視窗打字正常，多半是宿主層攔截、不是 Hyprland 配置錯。解法：先確認 VM 視窗有 focus；在 UTM 的鍵盤/輸入設定開「把系統快捷鍵送進 VM（capture input）」讓 ⌘ 組合進 guest。臨時繞過：需要重載配置這類動作，直接在已開的終端機下指令（如 source / hyprctl reload），不必卡在 ⌘ 鍵上

VM 必要環境變數

在 Hyprland 配置裡加入以下環境變數（只在 VM 中使用，實機要移除）：

1-- VM-only environment variables
2env = {
3    "WLR_RENDERER_ALLOW_SOFTWARE, 1",  -- 允許軟體渲染 fallback
4    "WLR_NO_HARDWARE_CURSORS, 1",      -- 停用硬體 cursor（VM 常見問題）
5    "LIBGL_ALWAYS_SOFTWARE, 1",        -- 強制 Mesa 軟體渲染
6}

如果上述仍無法啟動（virtio-gpu vGPU passthrough 的情況）：

1env = {
2    "AQ_NO_KMS_REQUIREMENT, 1",       -- 繞過 KMS 需求
3    "WLR_RENDERER, pixman",            -- 強制 pixman 軟體 renderer
4}

[已驗證] Hyprland 0.55（Aquamarine）+ UTM virtio-gpu-gl-pci 實測：GPU 加速模式下 Hyprland 直接走 VirGL/Venus，不需要 WLR_RENDERER 或 WLR_RENDERER_ALLOW_SOFTWARE。AQ_NO_KMS_REQUIREMENT 仍有效。軟體渲染 fallback 路徑（WLR_RENDERER=pixman）未測試——有 GPU 加速時不需要走這條。

VM 中應該關閉的效果

軟體渲染下，視覺效果是最大的效能殺手。建議在 VM 配置中停用：

 1hl.config({
 2    decoration = {
 3        blur = { enabled = false },     -- 模糊是 GPU 最重的效果
 4        shadow = { enabled = false },
 5        rounding = 0,
 6    },
 7    animations = {
 8        enabled = false,                -- 或設定極簡動畫
 9    },
10})

這些效果關閉後，基本的平鋪操作（切換視窗、移動 workspace、開關 app）在 VM 中應該足夠流暢。

效能預期

功能	軟體渲染	virtio-gpu-gl	裸金屬（實機）
基本平鋪操作	可用	順暢	順暢
視窗動畫	卡頓明顯	勉強可接受	流暢
模糊/透明	無法使用	卡頓	流暢
Waybar + Wofi	正常	正常	正常
多 Workspace 切換	正常	正常	正常
Firefox 瀏覽	明顯變慢	可用	正常

VM 的價值在於驗證配置邏輯，不在於評估視覺體驗。如果在 VM 裡覺得「卡」，不代表 Hyprland 本身慢——多數情況是 VM 圖形加速的限制。

Sway 作為 VM 初步驗證工具

如果 VM 中 Hyprland 跑得太吃力，可以先用 Sway 驗證 VM 的 Wayland 圖形棧是否正常：

1sudo pacman -S sway foot
2sway

Sway 比 Hyprland 輕量（基於 wlroots、沒有華麗動畫），如果 Sway 能跑，代表 VM 的 Wayland 環境是正常的，Hyprland 的問題只是效能不夠。如果連 Sway 都跑不動，要回去檢查 VM 的 GPU 設定。

VM vs 實機測試矩陣

VM 中可完整驗證

項目	說明
配置檔語法	Lua config 是否解析正確、require 拆分是否正常
Keybind 設計	快捷鍵邏輯、submap、modifier 組合
Window rules	float / workspace assignment / opacity 規則是否生效
Workspace 切換	workspace 編號、切換邏輯
Layout 選擇	dwindle vs master 的行為差異
Waybar 模組配置	JSON config + CSS styling 是否正確顯示
Wofi/Rofi 主題	啟動器的功能和外觀設定
Mako 通知樣式	通知的位置、配色、timeout
Hyprlock 佈局	鎖屏的輸入框位置和文字配置
Autostart 順序	exec-once 的程式是否正確啟動
環境變數	XDG、Qt、GTK 等環境變數是否正確設定
Stow 部署	dotfile repo 的 stow 是否正確建立 symlink
Bootstrap script	install.sh 的完整流程（安裝套件 + deploy 配置）
Caelestia CLI 指令	`caelestia shell`、`caelestia scheme` 等指令是否可執行

需要實機測試

項目	為什麼 VM 不行
多螢幕配置	VM 通常只有一個虛擬顯示器
HiDPI / fractional scaling	虛擬顯示器不模擬真實解析度行為
VRR / Adaptive Sync	需要支援 VRR 的真實螢幕
動畫流暢度	VM 的 GPU 加速不足以評估真實效能
模糊效果品質	軟體渲染下模糊不可用或品質差
觸控板 / 手勢	VM 沒有觸控板裝置
媒體鍵 / 亮度鍵	需要實體鍵盤上的 XF86 keycodes
NVIDIA 驅動設定	VM 不走 NVIDIA 驅動，所有 NVIDIA 配置無法測試
Screen sharing	PipeWire + portal 的完整鏈路在 VM 中測試無意義
Suspend / Resume	虛擬機的 suspend 行為跟實機不同
硬體 cursor 渲染	VM 用軟體 cursor，無法測試硬體 cursor 問題
藍牙 / WiFi 整合	需要實際硬體
電池 / 電源管理	筆電專屬功能
日常使用效能	只有在實機跑一段時間才能評估「能不能當主力」

務實的 VM 使用策略

VM 階段的目標是「把配置寫好、驗證邏輯、確認 bootstrap script 能跑」，不是「體驗 Hyprland 好不好用」。具體做法：

在 VM 中完成 Arch Linux 安裝 + Hyprland 套件安裝（怎麼把那台 Linux 從 ISO 裝起來、安裝程式選項怎麼判讀、裝完怎麼驗工具與連入，見 Linux 安裝與機器初始化）
關閉所有視覺效果（blur / animation / shadow）
寫好完整的 Hyprland 配置（keybind / rules / workspace / autostart）
寫好 waybar / wofi / mako 配置
測試 stow 部署流程（從 dotfile repo clone → stow → 配置生效）
測試 bootstrap script（install.sh 從零到完整桌面）
把驗證過的配置 commit 進 dotfile repo

到實機時，clone dotfile repo → 跑 install.sh → 補上硬體相關設定（monitor、GPU 驅動、觸控板）→ 打開視覺效果。VM 階段的工作在實機上幾乎不用重做。

模組五：Hyprland 配置 on Tarragon

Hyprland 安裝與環境建置

核心套件

GPU 驅動

AMD（推薦，開箱即用）

Intel（開箱即用）

NVIDIA（需要額外配置，非官方支援）

檢查 GPU 驅動狀態

桌面配套套件

登入管理器

從 TTY 直接啟動（最簡單）

greetd + tuigreet（推薦）

SDDM

首次啟動常見問題

配置格式：Lua 取代 hyprlang（v0.55+）

其他發行版

Fedora

NixOS

Ubuntu

安裝後的下一步

Hyprland 核心配置

配置檔位置與格式

模組化拆分

從舊格式遷移

Monitor 設定

筆電合蓋行為

Dotfile 管理策略

輸入裝置配置

Keybind 設計

修飾鍵（Modifier）：SUPER 是哪顆鍵

Bind 類型

基本操作

設計原則

Submap：模態快捷鍵

媒體鍵與硬體鍵

環境變數

NVIDIA 專用環境變數

VM 專用環境變數

Workspace、Window Rules 與外觀

Workspace 設定

Per-workspace layout 覆寫

Window Rules

查詢應用程式的 class 和 title

Layout 配置

Dwindle

Master

外觀設定

動畫設定

Autostart

Plugin 系統

Dotfile 結構對應

穩定性與維護的務實面

VM 與實機測試對照

Hyprland VM 環境設定與測試矩陣

UTM on Apple Silicon 設定

UTM 建 VM 的注意事項

VM 必要環境變數

VM 中應該關閉的效果

效能預期

Sway 作為 VM 初步驗證工具

VM vs 實機測試矩陣

VM 中可完整驗證

需要實機測試

務實的 VM 使用策略

修飾鍵（Modifier）：`SUPER` 是哪顆鍵