Linux Compton配置中哪些选项可用

Compton 配置选项速览

一 基础与运行控制

• 配置文件与日志
  • config / config-file：指定配置文件路径
  • log-level / log-file / quiet / debug：日志级别、日志文件、静默模式、调试模式
• 合成开关与渲染后端
  • backend：渲染后端，常用 xrender / glx
  • vsync：垂直同步，减少撕裂
  • no-opengl：禁用 OpenGL 加速（兼容性选项）
• 显示与刷新控制
  • output / output-name / output-monitor / output-scale / output-offset / output-rotate：多显示器选择、命名、缩放、偏移、旋转
  • max-frame-time / min-frame-time / frame-rate：帧时间/帧率上限与下限
  • max-cpu-usage：限制最大 CPU 占用率
• 窗口与焦点行为
  • focus-follows-mouse / focus-new-windows / focus-stealing-prevention：焦点跟随鼠标、新窗口获焦、防焦点窃取
  • fade-in / fade-out：窗口淡入淡出动画

二 视觉效果与模糊

• 透明度与背景
  • opacity / alpha / background-opacity / alpha-threshold / max-alpha：窗口/背景透明度、透明度阈值、最大透明度
  • ignore-root：忽略根窗口透明度（避免桌面背景异常）
• 阴影
  • shadow / shadow-radius / shadow-offset-x / shadow-offset-y / shadow-opacity / shadow-exponent / shadow-color / shadow-exclude：阴影开关、半径、偏移、透明度、衰减、颜色、排除规则
• 模糊
  • blur / blur-method / blur-size / blur-deviation / blur-radius / screen-edge-blur / bg_blur：模糊开关、算法（如 gaussian）、核大小、强度、半径、屏幕边缘模糊、背景模糊
• 其它视觉细节
  • mouse-shadow：鼠标指针阴影
  • border / border-width / border-color：窗口边框宽度与颜色
  • disable-mask：禁用窗口遮罩效果

三 规则与窗口匹配

• 窗口选择
  • ignore-windows / shadow-exclude：忽略指定窗口、阴影排除规则
• 透明度与特效规则
  • opacity-rule / transparency-rule：按窗口属性/程序设置透明度或特效策略（支持条件匹配）

四 配置文件与生效方式

• 配置文件位置
  • 常见路径：~/.config/compton.conf、/etc/xdg/compton.conf
• 启动与热重载
  • 命令行：compton --config /path/to/compton.conf
  • 重启方式（随环境而异）：如 killall compton && compton -f，或桌面会话/自启动脚本中重启；若以 systemd 管理，可用 systemctl --user restart compton（或全局 systemd 配置）
• 版本差异提示
  • 不同分支/版本（如 picom 与旧版 compton）选项名称与默认值可能不同，建议以 compton --help 与当前版本文档为准