ubuntu compton使用中的常见问题

Ubuntu 下 Compton 常见问题与排查

一 安装与运行

• 安装与启动
  • 安装：在 Ubuntu/Debian 上执行：sudo apt-get install compton
  • 手动启动：compton &
  • 开机自启：创建用户级 systemd 服务（推荐）
    /etc/systemd/user/compton.service

    [Unit]
    Description=Compton Window Composer
    After=xorg.target
    
    [Service]
    ExecStart=/usr/bin/compton --config %h/.config/compton.conf
    Restart=always
    
    [Install]
    WantedBy=default.target
    

    启用：systemctl --user daemon-reload && systemctl --user enable --now compton
• 检查运行状态
  • 查看进程：ps -e | grep compton
  • 查看版本：compton --version
• 快速排查
  • 若启动失败，先终止旧进程：killall compton，再以 compton & 前台运行观察输出。

二 配置与兼容性

• 配置文件位置
  • 用户配置：~/.config/compton.conf
  • 全局配置：/etc/xdg/compton.conf
• 关键选项与作用
  • backend：渲染后端，常用 “glx”（性能更好）或 “xrender”（兼容性更好）
  • vsync：垂直同步，设为 true/false 视显示器与驱动而定
  • shadow：窗口阴影，设为 true/false
  • opacity / alpha：窗口透明度
  • ignore_root：是否忽略根窗口透明度
• 桌面环境兼容
  • 与 GNOME/KDE 等自带合成器的桌面环境可能存在冲突或重复合成，建议仅在一个地方启用合成（例如仅保留 KWin 或 Mutter 的合成，或仅运行 Compton）。
• 配置语法与弃用项
  • 若出现弃用警告（如 no-dock-shadow、menu-opacity、glx-swap-method），按新规范调整：
    • menu-opacity → 改用 inactive-opacity / active-opacity
    • glx-swap-method → 移除或改用 backend “glx”
  • 示例最小可用配置（可按需增删）：

    backend = "glx"
    vsync = true
    shadow = true
    inactive-opacity = 0.93
    active-opacity = 1
    alpha-step = 0.01
    shadow-exclude = [ "name 'Notification'", "class_g ? 'Dmenu'" ]
    

• 冲突软件
  • 避免与其他合成器并存（如 xcompmgr、picom）。

三 性能与显示问题

• 性能优化
  • 优先选择 backend = “glx”（若驱动支持 OpenGL）
  • 不需要时关闭阴影：shadow = false
  • 减少透明度计算：opacity / alpha 仅在需要时启用
  • 视情况开关 vsync（true/false 各有取舍）
  • 资源限制：必要时用 cpulimit -l 50 -p <PID> 限制占用（先 ps aux | grep compton 获取 PID）
• 常见显示问题
  • 窗口闪烁/撕裂：切换 backend（glx/xrender）、调整 vsync、更新显卡驱动
  • 黑屏/花屏：回退到 xrender、关闭模糊/阴影、检查驱动与日志
  • 多显示器：添加 detect-transient = true、detect-client-leader = true 提升识别稳定性

四 日志与进阶排错

• 查看日志
  • 系统日志：grep -i compton /var/log/syslog
  • Xorg 日志：grep -i compton /var/log/Xorg.0.log
• 调试步骤
  • 前台运行观察输出：compton &
  • 逐项注释/恢复配置，定位触发问题的选项
  • 检查依赖与驱动：glxinfo | grep OpenGL、lspci | grep VGA
  • 提供关键信息以便进一步分析：发行版与版本、显卡型号与驱动、Compton 版本、配置文件与日志片段