CachyOS 是基于 Arch Linux 的滚动发行版，目标是在保留 Arch 软件生态的同时，提供偏性能取向的内核、调度器与默认配置。原作者使用约一个月后，整理了从安装、Btrfs 快照到 Niri/Wayland 输入法与剪贴板适配的实践。它更适合愿意处理滚动更新和桌面配置的用户；如果希望系统长期保持固定状态、尽量不维护，原作者并不建议直接采用。

一、安装前准备

原帖采用 UEFI 启动、CachyOS Desktop ISO 与 Ventoy 制作启动盘。双系统场景需要先处理几个前提：关闭 Secure Boot；Windows 侧关闭快速启动和休眠，并确认 BitLocker 不会妨碍分区调整。CachyOS 官方安装文档还建议至少准备约 30 GB 空闲空间。动手前应备份重要数据。

官方安装说明：CachyOS Installation Desktop/Laptop | CachyOS

启动安装器后依次确认语言、时区和键盘布局。引导器方面，原作者提到 Limine 是推荐选项；官方手动分区文档要求为 Limine 准备至少 4096 MiB 的 FAT32 EFI 分区并挂载到 /boot。原作者因为现有空间不足，改用 GRUB，并新建 1 GB FAT32 EFI 分区，挂载到 /boot/efi、设置 boot 标记。这里不能机械照抄：引导器、挂载点和 EFI 分区容量必须与自己的磁盘布局一致。

根分区挂载到 /，原作者沿用默认 Btrfs。CachyOS 会创建所需子卷，并默认使用 zram，因此通常不必另建交换分区。桌面环境可选 KDE、GNOME、Niri 或 Hyprland；原作者选择 Niri，后续桌面适配也主要针对 Niri/Wayland。

二、首次更新与回滚准备

安装完成后先执行完整系统更新：

sudo pacman -Syu

Btrfs 用户可以通过 Btrfs Assistant 管理 Snapper 快照。原作者观察到系统会在安装、更新或移除软件包时自动创建快照。需要注意，快照主要用于快速回滚错误变更，不能替代异机备份；同时应定期检查快照数量和磁盘占用。Snapper 的机制可参考 ArchWiki：Snapper - ArchWiki

原帖还给出了添加 archlinuxcn 镜像源、安装密钥环并更新系统的方案：

sudo pacman -S archlinuxcn-keyring
sudo pacman -Syu

第三方仓库地址会随地区和维护状态变化，加入前应从 archlinuxcn 官方说明确认当前仓库配置与签名，不要从不明页面复制镜像配置。

三、AUR 与软件安装

CachyOS 默认提供 yay。更新 AUR 软件可使用：

yay -Syu

不要在 yay 前加 sudo。AUR 包名常见约定是：无后缀通常从源码构建，-bin 使用预编译发行包，-git 跟踪最新源码，但具体包仍可能有例外。安装前应阅读 PKGBUILD、来源地址和用户评论，尤其要留意安装脚本、网络下载和长期无人维护的包。

四、Niri/Wayland 应用适配

QQ 输入法与 Wayland

原作者为 QQ 增加了以下启动参数，用于启用原生 Wayland 和输入法支持：

--ozone-platform=wayland
--enable-wayland-ime
--wayland-text-input-version=3

这些参数依赖 Electron 版本和桌面环境，升级后需要重新验证；若应用启动异常，应逐项移除定位。

VS Code 密钥存储

在 Niri 下遇到 VS Code 密钥环问题时，原作者在 ~/.vscode/argv.json 中把 password-store 设置为 gnome-libsecret。该设置要求系统已有相应 Secret Service 实现，且 JSON 语法必须保持有效。

剪贴板持久化与同步

原作者安装了：

yay -S wl-clip-persist comalot-clipsync-git

然后在 Niri 配置中加入启动项：

spawn-at-startup "wl-clip-persist" "--clipboard" "regular"

并启用用户服务：

systemctl --user enable --now clipsync

验证时可退出并重新登录，再检查 systemctl --user status clipsync，确认服务已启动且没有持续报错。

五、Fcitx5 与雾凇拼音

原作者安装的组件如下：

yay -S fcitx5 fcitx5-rime fcitx5-configtool fcitx5-gtk fcitx5-qt rime-ice-git

并在 Niri 环境配置中设置：

GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx
XMODIFIERS=@im=fcitx
SDL_IM_MODULE=fcitx
INPUT_METHOD=fcitx

随后通过 fcitx5-configtool 添加 Rime。ArchWiki 提醒，Wayland 原生输入法协议通常优于一刀切地设置环境变量；某些变量只需要提供给 XWayland 应用。因此遇到候选框位置、重复输入或部分应用无法输入时，应按具体应用和桌面环境缩小变量作用范围，而不是继续叠加配置。参考：Fcitx5 - ArchWiki

六、字体配置

原帖安装了常用中英文、等宽和 Emoji 字体，再通过 fontconfig 设定 sans-serif、serif、monospace 的优先级。修改后执行：

fc-cache -fv

可以用 fc-match sans-serif、fc-match serif 和 fc-match monospace 检查实际命中的字体。若中英文混排、Emoji 或代码字体异常，优先检查字体是否安装、fontconfig XML 是否完整，以及用户级配置是否覆盖系统配置。

验证与适用边界

安装完成后，至少检查以下项目：

findmnt / /boot /boot/efi
swapon --show
zramctl
snapper list
fcitx5-diagnose

这些命令分别帮助确认分区挂载、交换设备与 zram、快照和输入法状态；某个命令没有输出不一定代表故障，应结合自己实际选择的引导器和组件判断。

原作者的体验来自 Niri、Btrfs 和一套具体硬件/软件组合，并提到其机器启动后约占用 3 GB 内存、日常工作负载通常不超过 12 GB。这是个体观察，不是 CachyOS 的通用性能承诺。滚动发行版、AUR 和第三方仓库的状态会持续变化，执行配置前应对照当天的官方文档，并保留可恢复的备份。

原作者：DabblerLi（W）
原帖：https://linux.do/t/topic/2790488