介绍在 Linux 环境下配置 Logitech MX Master 鼠标的完整流程。涵盖环境检测、蓝牙连接、驱动安装（logiops）、基础功能参数设置（滚动、DPI）、高级手势定制、多设备切换及故障排除。通过命令行工具和配置文件实现精准控制与效率优化。
在 Linux 环境中，鼠标不仅是输入设备，更是效率倍增的关键工具。本文将通过'问题 - 方案 - 优化'三段式逻辑，带你深入探索 Logitech MX Master 鼠标的 Linux 配置之道，实现从基础连接到高级自定义的全流程优化。
在开始配置前，请确认你的系统环境满足以下要求：
首先确认你的 MX Master 鼠标是否已被系统识别：
# 查看蓝牙设备
bluetoothctl devices
# 或查看 USB 设备
lsusb | grep Logitech
根据你的 Linux 发行版选择以下命令安装基础依赖：
Ubuntu/Debian：
sudo apt update && sudo apt install -y bluez bluez-tools libinput-tools
Fedora/RedHat：
sudo dnf install -y bluez bluez-tools libinput
Arch Linux：
sudo pacman -S bluez bluez-utils libinput
使用 bluetoothctl 工具进行配对：
bluetoothctl
power on
scan on
pair [设备 MAC 地址]
trust [设备 MAC 地址]
connect [设备 MAC 地址]
exit
Linux 系统中，MX Master 鼠标的工作依赖于多层次的驱动架构：
MX Master 的特殊功能（如拇指按键、手势控制）需要用户空间工具支持，因为这些功能并未完全标准化，不同厂商实现方式各异。
| 工具名称 | 优势 | 劣势 | 适用场景 |
|---|---|---|---|
| libinput | 系统原生支持、资源占用低 | 高级功能有限 | 基础用户、追求稳定性 |
| solaar | 图形界面友好、多设备管理 | 部分功能支持不全 | 桌面环境用户、多 Logitech 设备 |
| logiops | 功能全面、高度可定制 | 配置复杂、无图形界面 | 高级用户、需要深度定制 |
Ubuntu/Debian：
sudo add-apt-repository ppa:patrick-fork/logiops
sudo apt update && sudo apt install -y logiops
Arch Linux：
yay -S logiops-git
logiops 的核心配置文件位于 /etc/logid.cfg，使用以下命令创建并编辑：
sudo nano /etc/logid.cfg
{
"devices": [
{
"name": "Logitech MX Master 3",
"smartshift": { "on": true, "threshold": 15 },
"dpi": 1600,
"scroll": { "natural_scroll": false, "invert": false, "hires": true }
}
]
}
sudo systemctl restart logid
小贴士：smartshift 阈值建议设置在 10-20 之间，数值越小，切换到自由滚动所需的速度越低。对于办公场景，15 是兼顾精确控制和快速滚动的理想值。
编辑配置文件，添加按键映射：
{
"buttons": {
"5": { "action": "Gestures" },
"gestures": {
"thumbwheel": {
"up": { "action": "Keypress", "keys": ["KEY_VOLUMEUP"] },
"down": { "action": "Keypress", "keys": ["KEY_VOLUMEDOWN"] }
},
"thumbbutton": {
"click": { "action": "Keypress", "keys": ["KEY_SUPER"] },
"hold": {
"action": "Gestures",
"gestures": {
"up": { "action": "Keypress", "keys": ["KEY_PAGEUP"] },
"down": { "action": "Keypress", "keys": ["KEY_PAGEDOWN"] },
"left": { "action": "Keypress", "keys": ["KEY_LEFTMETA", "KEY_LEFT"] },
"right": { "action": "Keypress", "keys": ["KEY_LEFTMETA", "KEY_RIGHT"] }
}
}
}
}
}
}
logiops 配置文件支持丰富的参数设置，以下是常用参数说明：
MX Master 的多设备切换功能在 Linux 下可通过 logiops 实现：
{
"devices": [
{ "name": "Logitech MX Master 3", "device": "/dev/hidraw0" },
{ "name": "Logitech MX Master 3", "device": "/dev/hidraw1" }
]
}
切换设备的快捷键可自定义：
# 安装 xdotool 用于模拟按键
sudo apt install xdotool
# 创建切换脚本
cat > ~/switch-mx-device.sh << 'EOF'
#!/bin/bash
# 切换到设备 1
xdotool key --clearmodifiers "ctrl+alt+1"
EOF
chmod +x ~/switch-mx-device.sh
使用 Git 同步配置文件：
# 初始化配置仓库
mkdir -p ~/.config/mx-master-config
cd ~/.config/mx-master-config
git init
# 复制配置文件
cp /etc/logid.cfg .
# 创建同步脚本
cat > sync-config.sh << 'EOF'
#!/bin/bash
sudo cp ~/.config/mx-master-config/logid.cfg /etc/
sudo systemctl restart logid
EOF
chmod +x sync-config.sh
为游戏场景创建专用配置文件：
{
"devices": [
{
"name": "Logitech MX Master 3",
"dpi": 3200,
"smartshift": { "on": false },
"scroll": { "hires": false, "invert": true },
"buttons": {
"4": { "action": "Keypress", "keys": ["KEY_5"] },
"5": { "action": "Keypress", "keys": ["KEY_6"] }
}
}
]
}
创建切换脚本：
cat > ~/switch-to-gaming-mode.sh << 'EOF'
#!/bin/bash
sudo cp ~/.config/mx-master-config/logid-gaming.cfg /etc/logid.cfg
sudo systemctl restart logid
echo "Switched to gaming mode"
EOF
chmod +x ~/switch-to-gaming-mode.sh
为创意工作设计的配置：
{
"devices": [
{
"name": "Logitech MX Master 3",
"dpi": 1200,
"scroll": { "natural_scroll": true, "hires": true },
"buttons": {
"5": {
"action": "Gestures",
"gestures": {
"thumbwheel": {
"up": { "action": "Keypress", "keys": ["KEY_CTRL", "KEY_PLUS"] },
"down": { "action": "Keypress", "keys": ["KEY_CTRL", "KEY_MINUS"] }
}
}
}
}
}
]
}
我们在主流 Linux 发行版上测试了 MX Master 系列鼠标的功能支持情况：
| 功能 | Ubuntu 22.04 | Fedora 36 | Arch Linux |
|---|---|---|---|
| 基本鼠标功能 | ✅ 正常 | ✅ 正常 | ✅ 正常 |
| 蓝牙连接 | ✅ 稳定 | ⚠️ 偶发断连 | ✅ 稳定 |
| 拇指按键 | ✅ 支持 | ✅ 支持 | ✅ 支持 |
| 手势控制 | ✅ 部分支持 | ✅ 部分支持 | ✅ 完全支持 |
| 智能滚动 | ✅ 支持 | ✅ 支持 | ✅ 支持 |
| 多设备切换 | ⚠️ 需手动配置 | ⚠️ 需手动配置 | ✅ 支持 |
可能原因：
解决步骤：
sudo nano /etc/udev/rules.d/50-bluetooth-power.rules
添加以下内容：
ACTION=="add", SUBSYSTEM=="bluetooth", KERNEL=="hci0", RUN+="/bin/sh -c 'echo 0 > /sys/class/bluetooth/hci0/device/power/control'"
# Ubuntu/Debian
sudo apt install --reinstall bluez
# Arch Linux
sudo pacman -Syu bluez
可能原因：
解决步骤：
sudo systemctl status logid
jsonlint /etc/logid.cfg
logid -v
查看输出中的设备名称，确保与配置文件中的名称一致。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online