Linux下Compton配置错误怎么办

Linux下Compton配置错误的排查与修复

一 快速定位问题

• 检查是否运行：执行命令查看进程，若未运行可前台启动观察输出。示例：ps -e | grep compton；前台启动：compton -b（后台）或 compton（前台）。前台能直接看到语法或显卡驱动报错。
• 确认配置文件路径：常见位置为**~/.config/compton.conf**、/etc/xdg/compton.conf或**/etc/compton.conf**。不确定时，先重命名旧配置为备份，再用最小化配置测试。
• 用最小化配置验证：新建临时配置仅保留必要项，例如：

  backend = "glx"
  vsync = false
  shadow = true
  

  保存后用 compton -c /tmp/minimal.conf 前台启动，若无报错再逐步恢复自定义项。
• 重启生效：修改后先结束旧进程再启动，例如：killall compton && compton &。如使用会话/自启动，请重启会话或重新登录。

二 常见报错与修复对照

三 配置语法与弃用项修正要点

• 配置语法以当前使用的 Compton 分支为准（不同分支对语法与可用选项支持不同）。常见为“键 = 值”的 INI 风格，也有使用块（section）的风格；请以你安装版本的示例与手册为准。
• 常见弃用与替换（出现警告即需修改，否则后续版本可能直接报错）：
  • no-dock-shadow → 使用 wintype { dock = { shadow = false } }
  • menu-opacity → 使用 wintype { popup_menu, dropdown_menu { opacity = 0.xx } }
  • vsync → 仅接受布尔值：true/false（旧写法如 "none" 仅为兼容，后续会移除）
  • glx-swap-method → 已弃用，直接删除该行
  • clear-shadow → 已移除，无需配置
  • paint-on-overlay → 已移除，无需配置
• 示例片段（仅演示替换思路，按你的版本语法微调）：

  # 基本
  backend = "glx"
  vsync = true
  shadow = true
  
  # 用 wintype 替代已弃用项
  wintype {
    dock = { shadow = false }
    popup_menu = { opacity = 0.95 }
    dropdown_menu = { opacity = 0.95 }
  }
  
  # 阴影与排除
  shadow-radius = 5
  shadow-offset-x = 1
  shadow-offset-y = 1
  shadow-opacity = 0.3
  shadow-exclude = [
    "name 'Notification'",
    "class_g ? 'Dmenu'",
    "class_g ? 'Dunst'"
  ]
  

  修改后重启 Compton 并观察是否还有警告或报错。

四 仍无法解决时的建议

• 回退到默认配置：将现有配置重命名，启动 compton 使用内置默认；确认默认能正常工作后再逐项加回自定义项。
• 切换后端测试：在 glx 与 xrender 之间切换，以排除显卡驱动/兼容性因素。
• 更新显卡驱动：特别是 NVIDIA/AMD 专有驱动，许多渲染问题由驱动版本引起。
• 前台运行获取完整日志：使用 compton -c /path/to/compton.conf 前台启动，复制终端输出用于进一步排查。
• 查阅你所使用分支的文档与示例配置：不同分支（如某些社区维护版）在选项与语法上差异较大，以对应版本的说明为准。