Ubuntu 下 Compton 配置不生效的排查与修复

一 快速自检

• 确认进程与启动方式：运行 ps -e | grep compton 检查是否已在运行；若未运行，先前台启动 compton & 观察输出。若已运行，先 killall compton 再按你的方式重新启动，避免旧进程未退出导致新配置被忽略。
• 核对配置文件路径与生效文件：常见路径为 ~/.config/compton.conf 与 /etc/xdg/compton.conf。若你用 systemd 启动，实际生效的是服务文件里 ExecStart= 指定的配置（例如 /usr/bin/compton --config /etc/compton.conf），修改用户目录下的文件不会自动生效。
• 前台调试定位：用调试参数直接跑一遍，能最快看到报错与警告，例如：
  compton --config ~/.config/compton.conf --log-level=debug
  日志通常输出到终端，也可能写入 ~/.cache/compton/compton.log。
• 查看系统日志：
  journalctl -xe
  或
  dmesg | grep compton
  用于发现启动失败、驱动/权限等系统层面问题。

二 常见原因与对应修复

• 配置文件路径或语法错误：确认使用正确的配置文件，并避免语法/拼写错误；必要时用最小化配置逐项排除。
• 合成器冲突：桌面环境可能自带或自动启用合成器（如 Mutter/GNOME Shell、KWin），会与 Compton 争抢合成，导致你的配置被覆盖或不起作用。解决：在系统“启动应用程序”中关闭自启动的 Compton，改用会话级前台启动；或改用兼容性更好的 xcompmgr 等替代方案。
• 会话类型不匹配：Compton 仅适用于 X11。如果你登录的是 Wayland 会话（Ubuntu 22.04+ 默认可能为 Wayland），Compton 不会生效。解决：注销，在登录界面齿轮图标选择 Ubuntu on Xorg，再启动 Compton。
• 后端与驱动问题：尝试切换 backend=xrender/glx；若 glx 报 “Failed to load GLX” 等，多半是显卡驱动问题。运行 ubuntu-drivers devices 查看推荐驱动并安装，必要时在 TTY 下操作或安全重启。
• Systemd 服务未正确启用或配置错误：若通过服务启动，确保服务已 daemon-reload 并 enable，且 ExecStart 指向你修改的配置文件。
• 配置项被弃用或冲突：新版 Compton 对部分选项（如 no-dock-shadow、menu-opacity、glx-swap-method、clear-shadow、paint-on-overlay 等）有弃用或行为变更，需按最新示例调整。
• 权限与日志缺失：遇到 “not authorized” 等提示，检查权限；同时确认日志路径可写，便于排查。

三 最小可用配置示例

• 建议先用这份最小化配置验证是否能生效（保存为 ~/.config/compton.conf）：
  backend = “glx”
  vsync = true
  shadow = true
  shadow-radius = 5
  shadow-offset-x = 1
  shadow-offset-y = 1
  shadow-opacity = 0.3
  opacity-rule = [ “90:class_g=‘Dmenu’”, “90:class_g=‘Dunst’” ]

  若 glx 启动失败，可改为：backend = “xrender”

• 验证步骤：
  1. 前台启动并观察输出：
     killall compton; compton --config ~/.config/compton.conf --log-level=debug
  2. 无报错后，改为后台常驻：
     compton --config ~/.config/compton.conf &
  3. 若用 systemd，创建/修正服务（示例）：
     sudo systemctl daemon-reload
     sudo systemctl restart compton
     并确保服务文件中 ExecStart 指向你正在使用的配置文件。

四 仍未解决时的建议

• 更新系统与显卡驱动：
  sudo apt update && sudo apt upgrade
  ubuntu-drivers autoinstall
  然后重启再试。
• 重装 Compton：
  sudo apt remove --purge compton && sudo apt install compton
• 更换合成器：若与桌面环境冲突严重，可改用 xcompmgr 等更兼容的方案。
• 提交有效信息求助：提供你的 Ubuntu 版本、会话类型（Xorg/Wayland）、显卡与驱动、Compton 启动方式（手动/自启/服务）、以及 调试日志 关键报错片段。