如何排查Compton配置故障

Compton 配置故障排查清单

一 快速定位运行状态与日志

• 确认进程是否在跑：运行命令查看是否有 compton 进程（如：ps -e | grep compton）。若未运行，先直接前台启动以便观察输出：compton &。
• 前台试运行获取即时报错：使用配置文件前台启动，能直接看到语法或运行期错误（如：compton --config ~/.config/compton.conf）。
• 查看服务与系统日志：若通过 systemd 管理，执行 systemctl status compton.service 与 journalctl -xe | grep compton 定位启动失败原因。
• 检查用户级日志：部分环境会在用户缓存目录写入日志（如：~/.cache/compton/compton.log），可用 tail -n 50 ~/.cache/compton/compton.log 查看。
  以上步骤能快速判断是“未启动”“配置错误”还是“运行时报错”。

二 核对配置文件路径与语法

• 确认配置文件位置：常见路径为 ~/.config/compton.conf 与 /etc/xdg/compton.conf。如文件不存在，可先创建再写入最小可用配置进行测试。
• 语法与键名检查：使用 compton --config /path/to/compton.conf 校验配置语法；同时留意键名拼写与层级是否正确。
• 最小化配置示例（先跑通再逐步加功能）：

  backend = "glx"
  vsync = true
  shadow = true
  

• 常见语法/路径类问题包括：路径写错、缺少引号或括号、键名拼写错误、层级结构不合法等。
  以上可快速排除“找不到配置”“语法错误”等基础问题。

三 清理已弃用或移除的选项

• 下列选项在新版本中已弃用/移除，需按新写法调整或删除：
  • 用 shadow = true/false 并在 wintype 中设置 shadow 的例外（如 dock、popup_menu、dropdown_menu），替代 no-dock-shadow、no-dnd-shadow、menu-opacity。
  • vsync 现在只接受布尔值：true/false（旧写法 "none" 虽被兼容但将停止工作）。
  • 删除 glx-swap-method（已在 v6 移除）。
  • 删除 clear-shadow、paint-on-overlay（已移除或自动启用，无需配置）。
• 修正示例（按新规范）：

  shadow = true
  wintype {
    dock = { shadow = false }
    popup_menu = { shadow = false; opacity = 0.95 }
    dropdown_menu = { shadow = false; opacity = 0.95 }
  }
  vsync = true
  # glx-swap-method "undefined"   # 删除
  # clear-shadow true             # 删除
  # paint-on-overlay true         # 删除
  

这些改动可避免因不兼容选项导致的启动失败或警告。

四 用二分法定位问题配置段

• 从最小化配置开始，逐步恢复你原有的段落（如 shadow、blur、opacity、fade、focus-exclude、shadow-exclude 等），每加一段就重启 Compton 验证。
• 对列表/字典类选项（如 shadow-exclude、focus-exclude）先清空或注释大半，再逐个恢复，快速识别“哪一条规则”引发问题。
• 若某特效导致卡顿或异常（如 blur），先关闭再验证，逐步缩小范围。
• 每次修改后用前台运行或查看日志确认是否复现，便于精确定位。
  这种“由简入繁”的二分法，能在复杂配置中迅速找出异常段落。

五 环境与兼容性修复

• 显卡驱动与后端选择：确保安装了合适的 GPU 驱动；在 backend 中优先尝试 glx，如遇兼容性或渲染问题再回退 xrender。
• 发行版与系统维护：在 CentOS/RHEL/Fedora 等环境，执行 sudo yum/dnf update 更新系统与依赖；必要时重装 Compton（如 sudo dnf reinstall compton）。
• Systemd 服务与自启：若使用服务管理，确保服务文件正确（如 After=xorg.service、ExecStart=/usr/bin/compton --config /etc/compton.conf），并执行 systemctl daemon-reload && systemctl enable --now compton。
• 特殊场景：部分在线游戏的反作弊机制可能与合成器冲突，必要时临时关闭 Compton 验证。
  这些步骤可解决多数“驱动/依赖/服务”层面的兼容性问题。