cachyos

分区失败 / 无法创建分区#

症状： 点击”新建分区”后无响应或提示”无法创建”

解决方案：

1. 确认已选中正确的硬盘（左侧列表中高亮显示）
2. 如果无法创建，先点击左侧的”新建分区表”，选择 GPT 格式
3. 重新尝试创建分区
4. 检查硬盘是否已被其他操作系统占用，必要时先删除所有分区（注意备份数据）

安装后无法进入 Linux 系统#

症状： 重启后卡在 GRUB 菜单，或无法选择 CachyOS 启动项

解决方案：

1. 重启进入 BIOS，确认 /boot/efi 分区所在硬盘的启动顺序（优先级最高）
2. 如果 GRUB 菜单不显示 CachyOS，执行命令更新 GRUB：

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

3. 如果仍无法启动，进入 Live USB 环境，挂载 Linux 分区后修复：

   1
   sudo mount /dev/sdXY /mnt  # 替换 X 和 Y
   2
   sudo arch-chroot /mnt
   3
   grub-install --target=x86_64-efi --efi-directory=/boot/efi

Windows 启动项被删除 / 无法进入双系统菜单#

症状： 安装后 GRUB 菜单只显示 CachyOS，Windows 不见了

解决方案：

1. 确认在 GRUB 配置中已设置 GRUB_DISABLE_OS_PROBER=false（见”grub配置”部分）
2. 执行更新命令：

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

3. 如果 Windows 仍未出现，可能是 Windows EFI 分区损坏，需要进入 Windows PE 修复

显卡驱动问题 / 分辨率不正常#

症状： 系统卡顿、分辨率低、屏幕闪烁

解决方案（NVIDIA 用户）：

1
sudo pacman -S nvidia nvidia-utils
2
# 重启系统

解决方案（AMD 用户）：

1
sudo pacman -S xf86-video-amdgpu
2
# 重启系统

解决方案（Intel 集显）：

1
sudo pacman -S xf86-video-intel
2
# 重启系统

网络无法连接#

症状： 安装完成后无网络连接或 WiFi 不工作

解决方案：

1. 有线网络不工作：

   1
   sudo systemctl restart systemd-networkd

2. 无线网络不工作，查看可用网络：

   1
   nmcli device wifi list

3. 连接 WiFi：

   1
   nmcli device wifi connect "SSID" password "PASSWORD"

中文输入法无法使用#

症状： Fcitx5 安装后仍无法切换到中文输入法

解决方案：

1. 确认已修改 /etc/environment 文件（见”安装输入法”部分）
2. 注销用户并重新登录
3. 打开”设置” → “键盘”，检查是否已添加 Fcitx5
4. 如果仍未显示，执行：

   1
   fcitx5-configtool

   手动添加”Pinyin”输入法

系统更新失败#

症状： 运行 pacman -Syu 后出现错误或包冲突

解决方案：

1
# 强制刷新所有包数据库
2
sudo pacman -Sy
3

4
# 再次尝试更新
5
sudo pacman -Syu
6

7
# 如果有包冲突，查看详细错误信息，必要时使用 paru：
8
sudo paru -Syu

系统启动缓慢#

症状： 开机从按下电源到出现桌面耗时过长

解决方案：

1. 检查启动过程：

   1
   systemd-analyze

2. 查看耗时最长的服务：

   1
   systemd-analyze blame

3. 禁用不必要的启动服务（如打印机支持）

Niri 窗管崩溃或卡顿#

症状： 窗口管理器无响应或频繁崩溃

解决方案：

1. 检查日志：

   1
   journalctl -xe

2. 重启 Niri（快捷键通常为 Super+Escape），或在终端执行：

   1
   niri --version  # 检查版本

3. 如果问题持续，尝试切换到 KDE Plasma 或其他桌面环境：

   1
   sudo pacman -S kde-plasma

基础配置文件位置#

1
mkdir -p ~/.config/niri
2
vim ~/.config/niri/config.kdl

常用自定义项#

1. 修改主题和外观

编辑 ~/.config/niri/config.kdl，查找主题配置部分（通常在文件开头），修改颜色和字体：

1
// 背景颜色
2
prefer-dark-mode
3

4
// 字体设置
5
font-family "Noto Sans CJK SC"
6
font-size 11

2. 快捷键自定义

在 config.kdl 中修改快捷键绑定。常见快捷键：

1
// 打开终端
2
binds {
3
    "Mod+Return" = spawn "alacritty";  // 替换为你的终端应用
4
}
5

6
// 应用切换
7
"Mod+Tab" = next-window;
8
"Mod+Shift+Tab" = prev-window;
9

10
// 工作区切换
11
"Mod+1" = activate-workspace 1;
12
"Mod+2" = activate-workspace 2;

3. 工作区设置

自定义工作区数量和行为（默认 10 个工作区）：

1
workspaces {
2
    ws-num 10;  // 工作区数量
3
}

4. 监视器配置

如果使用多显示器，配置每个显示器的分辨率和刷新率：

1
outputs {
2
    "HDMI-1" = {
3
        mode "1920x1080@60";  // 分辨率@刷新率
4
        position { x 0; y 0; };
5
    };
6
}

安装美化相关软件#

1. 终端美化

推荐使用 Alacritty（GPU 加速终端）和 Starship（提示符美化）：

1
sudo pacman -S alacritty starship

编辑 ~/.config/alacritty/alacritty.toml，自定义字体、主题、颜色：

1
[font]
2
family = "Noto Sans Mono CJK SC"
3
size = 11
4

5
[colors.primary]
6
background = "#1e1e2e"
7
foreground = "#cdd6f4"

2. 主题和图标

CachyOS 默认包含多套主题。安装额外主题和图标包：

1
sudo pacman -S papirus-icon-theme lxappearance

打开 lxappearance，选择喜欢的主题和图标。

3. 壁纸设置

设置桌面壁纸（使用 swaybg）：

1
sudo pacman -S swaybg
2

3
# 在 ~/.config/niri/config.kdl 中添加
4
exec swaybg -i /path/to/wallpaper.png

4. 状态栏和通知

Niri 生态中流行的状态栏工具：

1
# 安装 swaybar 或 waybar
2
sudo pacman -S waybar
3

4
# 配置文件位置
5
mkdir -p ~/.config/waybar