Debian Compton配置中如何处理多屏显示问题

Debian 下 Compton 多屏显示的正确做法

一 基础准备与多屏布局

• 确认系统已安装 Compton：sudo apt update && sudo apt install compton。
• 用 xrandr 查看并排布显示器，例如：xrandr --output HDMI-1 --auto --right-of eDP-1；必要时设置主屏：xrandr --output eDP-1 --primary。Compton 对多显示器是“开箱即用”的，关键在于让 X11 的显示拓扑正确，然后 Compton 会自动为每个输出合成。若使用显示管理器，也可在其“显示器”设置中拖拽摆放并应用。

二 配置文件要点与示例

• 配置文件路径：~/.config/compton.conf（不存在可新建）。
• 多屏无需在 Compton 里逐一指定输出名称；保持 backend 与重绘机制正常即可。示例：

  # 基本
  backend = "glx"
  vsync = true
  glx-swap-method = 1
  refresh-rate = 0
  
  # 重绘与性能
  use-damage = true
  unredir-if-possible = true
  detect-rounded-corners = true
  detect-client-leader = true
  
  # 阴影与透明度
  shadow = true
  shadow-radius = 12
  shadow-offset-x = -12
  shadow-offset-y = -12
  shadow-exclude = [
    "name = 'Notification'",
    "class_g = 'Conky'",
    "class_g = 'Polybar'",
    "_GTK_FRAME_EXTENTS@:c"
  ]
  fading = true
  fade-delta = 10
  
  # 多屏常见问题优化
  focus-exclude = [ "class_g = 'Cairo-clock'" ]
  detect-transient-windows = true
  wintypes :
  {
    dock = { shadow = false; }
    tooltip = { shadow = false; }
  }
  

  说明：Compton 默认支持多显示器，无需“xrandr-output …”这类指令；以上参数用于减少跨屏阴影、避免面板/通知干扰、提升重绘效率。

三 启动与自启动

• 手动测试：compton --config ~/.config/compton.conf。
• 会话自启动：将 compton --config ~/.config/compton.conf 加入窗口管理器/会话的启动脚本（如 Openbox 的 autostart、i3 的 config、Xfce 的“会话和启动”）。
• systemd 用户服务（推荐，避免与登录会话时序冲突）：创建文件 ~/.config/systemd/user/compton.service

  [Unit]
  Description=Compton compositor
  After=graphical-session.target
  
  [Service]
  ExecStart=/usr/bin/compton --config %h/.config/compton.conf --log-file %h/.local/share/compton.log
  Restart=on-failure
  
  [Install]
  WantedBy=default.target
  

  启用：systemctl --user daemon-reload && systemctl --user enable --now compton.service。若使用系统级服务，请确保 After=display-manager.service 并正确设置环境变量。

四 常见问题与排查

• 阴影跨屏或出现在面板/通知上：在 shadow-exclude 中排除 name 或 class_g（如上示例），并对 dock/tooltip 关闭阴影。
• 窗口拖到副屏后淡入淡出或透明度异常：保持 use-damage = true，必要时调大 fade-delta；确认未对特定 wintype 错误启用/禁用效果。
• 性能或撕裂：启用 vsync（glx-swap-method=1 常配合），确保 use-damage 开启；显卡驱动与 compositor 不匹配时可临时改用 backend = “xrender” 验证。
• 多屏热插拔/唤醒后异常：重启 Compton（systemctl --user restart compton.service），或在登录会话中确保只启动一个 Compton 实例。
• 鼠标跨屏或窗口位置异常：先用 xrandr 校正显示器相对位置与主屏，再重启会话/Compton。