Compton配置文件解析：你需要知道的关键点

Compton 配置文件解析的关键点

想在 X11 环境下获得更流畅、更美观的桌面视觉体验？窗口合成器 Compton 是个经典选择。不过，要让它在你的系统上完美运行，一份得心应手的配置文件必不可少。今天，我们就来深入聊聊 Compton 配置的核心要点。

一 基础与环境

首先，得明确一点：Compton 是专为 X11 设计的窗口合成器。如果你已经切换到 Wayland 会话，那它通常就不起作用了。

• 渲染后端：这决定了合成的底层引擎。主流选择是 glx（或者环境支持的 egl）和 xrender。怎么选？如果你的显卡驱动良好，优先用 glx/egl，动画效果通常更顺滑；如果遇到兼容性问题，再回退到更稳定的 xrender。
• 配置文件在哪：个人配置推荐放在 ~/.config/compton.conf，系统级配置则在 /etc/xdg/compton.conf。如果文件不存在？自己创建一个就行。
• 配置语法：这里有个小坑，Compton 支持两种风格，但切记不要在同一文件里混用：
  • 类 C 风格：键值对，比如 key = value; 或者简写为 key value;。
  • 类 JSON 风格：使用块和数组，例如 shadow-exclude { "class_g 'GtkMenu'"; } 或者 shadow-exclude = [ "class_g 'GtkMenu'", "class_g 'GtkDialog'" ];。
• 从零开始：一个最小可用示例：把下面这段代码保存为 ~/.config/compton.conf，你就有了一个能工作的起点：

  backend = "glx";
  vsync = true;
  shadow = true;
  shadow-radius = 2;
  shadow-offset-x = 2;
  shadow-offset-y = 2;
  shadow-opacity = 0.5;
  fade = true;
  fade-delta = 10;
  background = "#000000";
  opacity-rule = ["90:class_g = 'Firefox'",
                  "90:class_g = 'Alacritty'"];
  shadow-exclude = ["class_g 'GtkMenu'",
                    "class_g 'GtkDialog'",
                    "class_g 'Notification'"];

  这个配置开启了基础阴影、淡入淡出效果，并为 Firefox 和 Alacritty 设置了透明度，同时排除了菜单、对话框和通知的阴影。当然，具体可用的选项会因你安装的版本和编译参数略有不同。

二 关键参数速览

面对众多参数是不是有点眼花？别急，下面这张表帮你快速抓住重点：

三 启动与自启动

配置好了，怎么让它跑起来？手动和自动，各有各的用法。

• 手动启动与热重载：
  • 直接启动：compton --config ~/.config/compton.conf
  • 重启生效（比如修改配置后）：pkill compton && compton --config ~/.config/compton.conf &
  • 后台模式：compton -b --config ~/.config/compton.conf &
• Systemd 用户服务（推荐）：用系统服务管理，能避免不少权限和会话问题，还能实现开机自启。
  • 创建服务文件：~/.config/systemd/user/compton.service，内容如下：

    [Unit]
    Description=Compton Compositor
    After=graphical-session.target
    
    [Service]
    ExecStart=/usr/bin/compton --config %h/.config/compton.conf
    Restart=always
    
    [Install]
    WantedBy=default.target

  • 启用并启动它：systemctl --user daemon-reload && systemctl --user enable --now compton.service

四 性能优化与常见问题

最后，我们来解决两个最实际的问题：怎么让它跑得更快，以及出了问题怎么办。

• 性能优化
  • 选对引擎：还是那句话，优先尝试 glx/egl 后端。
  • 按需关闭特效：如果不需要阴影和淡入淡出，关掉 shadow 和 fade 能立刻减轻负担。同样，减少不必要的透明度规则和模糊效果。
  • 微调参数：适度降低 blur-size 或 frame-rate。遇到画面撕裂就打开 vsync；如果对游戏、视频的输入延迟敏感，不妨关掉它试试效果。
  • 精准排除：善用 exclude 和 shadow-exclude 规则，把通知、菜单、Dock、面板这些不需要合成或阴影的元素排除在外。玩全屏游戏或看视频时，临时禁用合成器能释放更多资源。
• 故障排查
  • 配置错误导致黑屏/崩溃：先在终端直接运行 compton 看输出错误信息。或者，用一个最小化的配置文件逐项添加测试，定位问题选项。
  • 应用渲染异常（花屏、残影）：尝试切换 backend，或者调整 glx-damage、glx-fbo、glx-no-stencil 这类 OpenGL 细粒度选项。
  • 阴影异常：检查并完善你的 shadow-exclude 规则，确保菜单、通知、Dock/面板等元素已被正确排除。
  • 版本差异：需要警惕的是，像 bg_blur、screen_edge_blur 这类高级模糊选项，只在特定编译版本的 Compton 中提供。如果配置不生效，先确认一下你用的版本是否支持。
  • 桌面环境差异：GNOME、KDE、Xfce 等桌面环境通常自带合成器。同时启用 Compton 可能会与系统特效冲突。常见的做法是先禁用系统自带的合成器，再使用 Compton。