Debian系统中Compton的调试技巧

Debian下Compton调试技巧

一 快速定位与最小复现

• 确认进程与版本：运行ps -e | grep compton查看是否在运行；必要时用compton --version确认版本。若未运行，先前台启动以便观察输出：compton &。
• 前台调试启动：使用配置文件前台运行并开启调试输出，便于直接看到警告与错误：compton --config ~/.config/compton.conf -f。
• 最小化配置法：将配置收敛到最小集（如仅保留必要选项），逐步恢复被注释项，定位触发问题的选项。
• 会话级复现：退出图形会话后仅启动Xorg + compton（如通过startx），排除桌面环境自启动脚本干扰。
• 配置路径与生效：常见位置为**~/.config/compton.conf与/etc/xdg/compton.conf**；修改后需重启Compton或重登会话生效。

二 日志与Systemd服务化调试

• Systemd服务模板（用户级更稳妥）：创建**~/.config/systemd/user/compton.service**，内容示例：

  [Unit]
  Description=Compton Window Composer
  After=graphical-session.target
  
  [Service]
  ExecStart=/usr/bin/compton --config %h/.config/compton.conf -f
  Restart=on-failure
  Environment=XDG_RUNTIME_DIR=/run/user/%U
  
  [Install]
  WantedBy=graphical-session.target
  

  启用与查看日志：

  systemctl --user daemon-reload
  systemctl --user enable --now compton
  journalctl --user -u compton -b
  

• 系统级服务要点：若使用**/etc/systemd/system/compton.service**，在**[Service]中设置User=你的用户名**，并选择After=xorg.service或After=display-manager.service；修改后用sudo systemctl daemon-reload重载。
• 日志路径与实时跟踪：部分环境或版本会将日志写入**~/.cache/compton/compton.log**，可用tail -f实时查看；同时结合journalctl获取标准输出与错误。

三 配置开关的二分法定位

• 渲染与合成相关：逐一开关shadow、fade、blur、transparency、vsync、backend（如glx、xrender），观察问题是否消失，以判定是否为渲染路径或特效触发。
• 窗口匹配规则：利用opacity-rule对特定应用设置临时不透明或关闭特效，确认是否为特定程序窗口导致。
• 刷新与同步：调整refresh-rate、vsync与sw-opti等选项，排查撕裂、卡顿与高CPU占用。
• 经验性快速集：
  • 仅保留必要特效（如仅阴影），其余先关闭；
  • 将shadow-exclude与fade-exclude放宽，排除规则误伤；
  • 使用**–paint-on-overlay**等开关验证合成器与窗口重绘路径。

四 性能与内存问题排查

• CPU占用高：用top/htop定位compton进程，配合**perf top -p $(pidof compton)查看热点函数；必要时用cpulimit -l 50 -p $(pidof compton)**临时限流，验证对交互的影响。
• 内存问题：在可控场景下用valgrind --tool=memcheck --leak-check=full compton（注意性能极慢，仅用于问题复现与定位）。
• 渲染与驱动：确认glxinfo | grep "OpenGL renderer"输出正常；在NVIDIA专有驱动下，尝试切换backend=glx/xrender并调整vsync策略，排除驱动与合成器协同问题。

五 常见症状与对策

• 启动即退或黑屏：前台以**-f启动观察输出；检查配置文件语法与路径；用最小化配置逐步恢复；确认backend与vsync**设置与驱动匹配。
• 阴影/模糊异常：逐项关闭shadow、blur并排除特定窗口（通过规则）；检查shadow-exclude与fade-exclude。
• 高CPU或卡顿：关闭fade与blur等高开销特效；降低刷新相关参数；用perf定位热点；必要时限流验证。
• 特定应用异常：用opacity-rule对该应用临时禁用特效，确认是否为客户端渲染或合成器互操作问题。
• 会话不生效：确认使用systemctl --user启用用户级服务，且After=graphical-session.target；必要时在登录后延时启动（如sleep 2 && compton …）。