Linux下Compton安装步骤全解析

Linux下 Compton 安装步骤全解析

一 安装前准备与注意事项

• Compton 是 X11 的轻量级窗口合成器，提供窗口阴影、透明度、淡入淡出等效果；它并非 Wayland 合成器。若使用 Wayland 会话（如 GNOME on Wayland），应改用 Mutter 自带的合成器或其他 Wayland 方案。另请注意，部分桌面环境（如 KDE Plasma、GNOME Shell）自带合成器，启用外部合成器可能冲突或无效。为获得最佳兼容性，建议在 X11 会话下使用（如 i3、Openbox、Xfce、LXQt 等）。

二 发行版仓库安装（推荐）

• 更新索引并安装：
  • Debian/Ubuntu 系列
    • sudo apt update
    • sudo apt install compton
  • Fedora/CentOS/RHEL 系列
    • sudo dnf install compton（如仓库缺失可先启用 EPEL：sudo dnf install epel-release）
  • Arch Linux
    • sudo pacman -S compton
• 以上命令为各发行版最常见安装方式，适合大多数用户与稳定环境。

三 从源码编译安装（可选）

• 安装构建依赖（以 Debian/Ubuntu 为例，其他发行版请使用等效包名）：
  • sudo apt install git cmake build-essential libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libxdamage-dev libxext-dev libxi-dev mesa-utils libgl1-mesa-dev
• 获取源码并构建：
  • git clone https://github.com/chjj/compton.git
  • cd compton
  • mkdir build && cd build
  • cmake …
  • make -j$(nproc)
  • sudo make install
• 说明：不同分支/仓库可能存在差异，上述为常见流程；如从其他 fork 构建，请按其文档调整依赖与命令。

四 启动与开机自启

• 手动启动（X11 会话）：
  • compton（如需指定配置：compton --config ~/.config/compton.conf）
• 登录自启动（推荐方式，按桌面环境选择其一）：
  • XDG 自启动：创建文件 ~/.config/autostart/compton.desktop，内容示例：
    • [Desktop Entry]
    • Type=Application
    • Exec=compton --config ~/.config/compton.conf
    • Hidden=false
    • NoDisplay=false
    • X-GNOME-Autostart-enabled=true
    • Name=Compton
  • 窗口管理器配置：将 compton 加入 i3 的 exec 配置段，或在 Openbox 的 autostart 中追加 compton。
• 不建议使用 systemd --user 在登录图形会话前启动 Compton（易出现会话未就绪导致的失败）；如使用 systemd 管理服务，请确保 After=graphical.target 并仅在 X11 会话下启用。

五 验证与常见问题

• 验证运行：
  • 查看进程：ps aux | grep compton
  • 查看版本：compton --version
  • 观察窗口是否出现阴影、透明度、淡入淡出等效果
• 故障排查要点：
  • 确认处于 X11 会话；在 Wayland 下 Compton 不会生效。
  • 检查显卡驱动与 OpenGL 支持是否正常（glxinfo | grep OpenGL）。
  • 核对配置文件语法与选项（如 backend、shadow、opacity 等），必要时简化配置逐项排查。
  • 查看日志与输出：启动时添加 --log-level 与 --log-file 参数，或使用 journalctl 查看相关日志。