如何排查Debian Compton显示问题

Debian Compton 显示问题排查指南

一 快速定位与最小复现

• 确认会话类型：Compton 仅适用于 X11。在 Wayland 会话下不会生效，需在登录界面切换到 Xorg 再测试。若使用显示管理器（如 LightDM/GDM），可在会话选择中改为 Xorg。
• 检查是否运行：执行 ps aux | grep compton 查看进程；若未运行，前台启动以便观察输出：compton -c ~/.config/compton.conf。前台运行能即时看到报错与警告。
• 版本与安装：确认安装与版本 compton --version；缺失则 sudo apt update && sudo apt install compton。
• 最小配置启动：先备份当前配置 mv ~/.config/compton.conf ~/.config/compton.conf.bak，以默认配置启动 compton -b（后台）或 compton -c（前台），验证是否为配置导致。
• 重启与观察：修改配置后重启 Compton（见下文命令），再复现问题并观察变化。

二 日志与系统信息收集

• 前台调试输出：使用详细日志启动 compton -v，便于直接看到初始化与渲染相关提示。
• 环境变量调试：开启调试日志并指定文件
  • export COMPTON_DEBUG=1
  • export COMPTON_LOG_FILE=/tmp/compton.log
  • compton
• systemd 日志：若以服务运行，查看 journalctl -u compton.service -b --no-pager -p err 获取本次启动的错误级别日志；实时跟踪用 -f。
• 系统日志：检查 cat /var/log/syslog | grep compton 或 dmesg | grep compton 捕获内核/系统层面的相关线索。
• Xorg 日志：图形栈相关错误常记录在 /var/log/Xorg.0.log，可用 cat /var/log/Xorg.0.log | grep -iE "compton|glx|render" 检索。
• 配置与缓存：核对配置文件路径（常见为 ~/.config/compton.conf、/etc/xdg/compton.conf），必要时查看缓存/日志目录（如 ~/.cache/compton/）中的输出。

三 常见症状与对应处理

• 屏幕闪烁、撕裂或卡顿：在配置或命令行中调整 –vsync（如设为 drm/opengl/none 逐一测试）与 –frame-rate（如 60/120），观察是否改善；必要时降低特效复杂度。
• 透明度/阴影异常：暂时关闭相关特效（如 shadow = false; opacity-rule = [];），再逐项恢复定位触发项；检查 shadow-exclude 是否误伤目标窗口。
• 高 CPU/内存占用：减少阴影、模糊、窗口规则等开销；尝试切换 backend（如 glx 与 xrender 对比），并确认驱动与硬件加速可用。
• 特定应用渲染异常：用 xprop | grep "_NET_WM_WINDOW_OPACITY" 等工具确认窗口属性；为该应用添加 shadow-exclude/fade-exclude/opacity-rule 例外。
• 特定显卡/驱动问题：某些驱动需要特定参数（如启用/禁用某些特性），可先回退到稳定版本或尝试替代后端。

四 配置与重启的正确方式

• 配置文件位置与生效：优先使用 ~/.config/compton.conf；若使用 /etc/xdg/compton.conf 或系统级服务，注意权限与范围。修改后需重启 Compton 才能生效。
• 重启方法：
  • 前台调试：compton -c ~/.config/compton.conf（Ctrl+C 停止）
  • 后台运行：compton -b（已运行时先 pkill compton 再启动）
  • systemd 服务：sudo systemctl restart compton（如已配置为服务）
• 验证：重启后打开含透明/阴影/动画的应用（如浏览器、终端、文件管理器）逐项观察。

五 仍未解决时的替代与求助

• 替代合成器：临时切换到 xcompmgr 或 picom 以确认是否为 Compton 本身问题：xcompmgr -c & 或安装 picom 后启动，观察问题是否消失。
• 重装与更新：执行 sudo apt remove --purge compton && sudo apt install compton 清理后重装；同时 sudo apt update && sudo apt upgrade 更新系统与依赖。
• 提交信息要点：准备你的 Debian 版本、会话类型（Xorg/Wayland）、显卡与驱动、Compton 版本、最小复现步骤、相关 日志片段（journalctl、Xorg.0.log、compton 前台输出或自定义日志）。