Ubuntu Compton与Gnome集成方法

Ubuntu 下将 Compton 与 GNOME 集成

一 前置说明与前提

• Compton 是 X11 下的窗口合成器，提供阴影、透明度、淡入淡出等效果；GNOME Shell 在 Wayland 会话中自带合成器 Mutter，两者不会同时生效。要在 GNOME 中使用 Compton，请先切换到 GNOME on Xorg 会话。可在登录界面齿轮图标中选择“Ubuntu on Xorg”，或在 GDM 配置中设置。

二 安装与准备

• 安装 Compton（若仓库版本较旧，可考虑使用 picom 作为替代，启动命令与配置思路基本一致）：
  • sudo apt update
  • sudo apt install compton
• 准备配置目录与文件：
  • mkdir -p ~/.config
  • nano ~/.config/compton.conf
• 建议的基本配置示例（可按需调整）：
  • backend = “glx”
  • vsync = true
  • shadow = true
  • shadow-exclude = [ “name=‘gnome-shell’”, “class_g=‘Gnome-panel’”, “class_g=‘gnome-shell-extensions’” ]
  • fade = true
  • fade-delta = 10
  • unredirect-translucent-windows = true
  • glx-no-stencil = true
  • glx-copy-from-front = false
  • mark-wmwin-focused = true
  • mark-ovredir-focused = true
  • detect-rounded-corners = true
  • detect-client-leader = true
  • wintypes :
    • popup-menu =
    • dropdown-menu =
    • tooltip =
    • dock =
    • dnd =
    • normal = 说明：上述示例关闭 GNOME Shell 自身窗口的阴影以避免重影，启用淡入淡出与 VSync，减少撕裂与卡顿。

三 启动与自启动

• 会话内临时启动（用于测试）：
  • compton --config ~/.config/compton.conf &
• 图形化自启动（推荐）：
  • 方式 A：使用“启动应用程序”（gnome-session-properties）
    • sudo apt install gnome-session-properties
    • 打开“启动应用程序”，添加命令：compton --config ~/.config/compton.conf
  • 方式 B：使用 XDG 自启动（.desktop 文件）
    • 创建文件：~/.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
• 使配置生效：
  • 注销并重新登录，或按 Alt+F2 输入 r 回车以重启 GNOME Shell（仅对 Xorg 有效）。

四 常见问题与排错

• 登录后黑屏、撕裂或抖动：
  • 检查是否处于 Xorg 会话；在配置中启用 vsync（或尝试 opengl-sync 选项），并将 backend 调整为 glx 或 x11 对比；必要时降低阴影/模糊相关特效。
• 阴影重影或 GNOME 顶部面板异常：
  • 在 shadow-exclude 中排除 gnome-shell、Gnome-panel 等窗口类。
• 透明度/淡入淡出不生效：
  • 确认 fade = true、fade-delta 合理；某些应用（如部分浏览器）可能设置了不透明属性，需按应用调整规则。
• 需要手动重启 Compton：
  • killall compton 后重新执行启动命令，或注销/登录会话。
• 使用 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
  • 注意：GNOME 会话通常使用用户级服务更合适，避免与显示管理器级服务冲突。