Linux下Compton的安装教程

Linux下Compton安装教程

1. 安装Compton

1.1 通过发行版软件仓库安装（推荐新手）

• Ubuntu/Debian系：
  更新软件包列表并安装Compton（部分新版本系统可能用picom替代，若需最新特性可选择picom）：

  sudo apt update
  sudo apt install compton  # 或 sudo apt install picom
  

• Arch Linux/Manjaro：
  使用pacman安装Compton或其增强版picom：

  sudo pacman -S compton    # 或 sudo pacman -S picom
  

• Fedora/RHEL系：
  通过dnf安装Compton：

  sudo dnf install compton
  

1.2 从源码编译安装（获取最新版本/定制功能）

若需最新特性或修改源码，可通过源码编译安装：

# 克隆Compton仓库（以官方仓库为例）
git clone https://github.com/yshui/compton.git
cd compton

# 安装编译依赖（Ubuntu/Debian为例，其他发行版请调整）
sudo apt install build-essential cmake git libx11-dev libxcomposite-dev libxdamage-dev libxrandr-dev libxinerama-dev libgl1-mesa-dev

# 创建构建目录并编译
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)  # 使用多核编译加速
sudo make install

1.3 版本兼容性建议

若系统默认安装的Compton版本较旧（如部分发行版的稳定版），建议改用picom（Compton的活跃分支，持续维护）：

# Ubuntu/Debian
sudo apt install picom

# Arch Linux
sudo pacman -S picom

2. 基本配置

2.1 生成默认配置文件

Compton的配置文件通常存放在~/.config/compton/compton.conf，首次使用需生成默认模板：

mkdir -p ~/.config/compton  # 创建配置目录
compton --example-config > ~/.config/compton/compton.conf  # 生成默认配置

2.2 常用配置选项（编辑compton.conf）

用文本编辑器（如nano、vim）打开配置文件，调整以下常用参数：

# 启用窗口阴影（提升视觉层次感）
shadow = true;

# 设置窗口透明度（active为活动窗口，inactive为非活动窗口）
active-opacity = 1.0;      # 活动窗口完全不透明
inactive-opacity = 0.8;    # 非活动窗口80%透明度

# 阴影排除规则（避免菜单、通知等窗口出现阴影）
shadow-exclude = [
    "*.menu",              # 排除菜单窗口
    "*.notification",      # 排除通知窗口
    "gnome-panel",         # 排除GNOME面板
    "krunner"              # 排除KDE runner
];

# 启用背景模糊（需显卡支持）
blur-background = true;
blur-background-exclude = [ "window_type *= 'dock'", "window_type *= 'desktop'" ];  # 排除Dock、桌面

# 启用淡入淡出效果（窗口开关时的过渡动画）
fade = true;
fade-in-step = 0.03;       # 淡入步长（0~1）
fade-out-step = 0.03;      # 淡出步长（0~1）

# 后端设置（推荐glx，兼容性更好）
backend = "glx";

# 垂直同步（避免画面撕裂）
vsync = "opengl-swc";      # 使用OpenGL交换控制

2.3 验证配置文件语法

修改配置文件后，可通过以下命令检查语法是否正确（无输出则表示正常）：

compton --config ~/.config/compton/compton.conf --test

3. 启动Compton

3.1 手动启动（临时测试）

在终端中执行以下命令，启动Compton并指定配置文件（-b表示后台运行）：

compton --config ~/.config/compton/compton.conf -b

3.2 自动启动（永久生效）

3.2.1 桌面环境（如GNOME/KDE）

• 打开“系统设置”→“启动应用程序”→“添加”；
• 在“命令”栏输入Compton启动命令（带配置文件路径），点击“添加”即可。

3.2.2 窗口管理器（如i3/Sway）

在窗口管理器的配置文件（如~/.config/i3/config或~/.config/sway/config）中添加以下行：

exec --no-startup-id compton --config ~/.config/compton/compton.conf -b

保存文件后重启窗口管理器（如i3中按Mod+Shift+R）。

3.2.3 Systemd服务（系统级自动启动）

若需以系统服务形式自动启动，可创建Systemd服务文件：

sudo nano /etc/systemd/system/compton.service

写入以下内容（替换/usr/bin/compton为实际路径，可通过which compton查看）：

[Unit]
Description=Compton Window Composer
After=xorg.service

[Service]
ExecStart=/usr/bin/compton --config /home/你的用户名/.config/compton/compton.conf
Restart=always
User=你的用户名

[Install]
WantedBy=multi-user.target

保存后执行以下命令启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable compton  # 设置开机自启
sudo systemctl start compton   # 立即启动

4. 常见问题解决

4.1 黑屏/无效果

• 冲突排查：关闭系统自带的合成器（如GNOME的Mutter、KDE的KWin），避免重复合成。例如，在GNOME中可通过“设置”→“区域与语言”→“输入源”→“选项”→“禁用合成器”测试。
• GPU加速禁用：若显卡驱动不兼容，尝试禁用GPU加速，使用xrender后端：

  compton --backend xrender --config ~/.config/compton/compton.conf -b
  

4.2 性能问题

• 更换轻量后端：将backend设置为xrender（适合老旧设备）：

  backend = "xrender";
  

• 减少特效强度：降低阴影范围、模糊强度或关闭淡入淡出效果（修改shadow-radius、blur-strength、fade-step等参数）。

4.3 版本兼容性问题

若系统默认Compton版本过旧（如缺少blur-background等新特性），建议卸载旧版本并安装picom（Compton的活跃分支）：

# Ubuntu/Debian
sudo apt remove compton
sudo apt install picom

# Arch Linux
sudo pacman -R compton
sudo pacman -S picom

5. 卸载Compton

根据发行版选择对应命令：

• Ubuntu/Debian：

  sudo apt remove compton
  

• Arch Linux：

  sudo pacman -R compton
  

• Fedora/RHEL：

  sudo dnf remove compton
  

通过以上步骤，您可完成Compton的安装、配置与启动。如需更高级功能（如窗口规则、动画效果），可参考Compton官方文档或社区教程。