AntiMicroX 使用指南：6 步把手柄变成键盘鼠标

AntiMicroX 使用指南：6 步把手柄变成键盘鼠标

【免费下载链接】antimicroxGraphical program used to map keyboard buttons and mouse controls to a gamepad. Useful for playing games with no gamepad support.项目地址: https://gitcode.com/GitHub_Trending/an/antimicrox

手柄插上了电脑，游戏却只认键盘——反派的 R 键在键盘右下角，你的手指却够不着。开源工具 AntiMicroX 解决的就是这件事：它把游戏手柄的按键、摇杆、扳机映射成键盘与鼠标输入，也就是俗称的"手柄转键盘"，让你用手柄操控只支持键盘鼠标的程序。下面按"插上手柄到真正玩起来"的顺序走一遍，全部操作在图形界面里点完即可。

安装 AntiMicroX：三种装法挑一种

这一步解决"程序从哪来"。不同系统的装法如下：

# Linux（推荐 Flatpak，绝大多数发行版通用） flatpak install flathub io.github.antimicrox.antimicrox

• Windows：到发行版发布页下载antimicrox-X.X.X-AMD64.exe安装包，双击装完即用；
• Linux 其他渠道：Fedora 可dnf install antimicrox，openSUSE 可zypper install antimicrox，Arch 系可用 AUR 源，或从发布页拿.deb/AppImage 包；
• macOS：项目未提供官方包，可从源码构建（见文末"给感兴趣的你"）。

装好后直接启动，不需要额外配置驱动。

连接手柄并确认被识别

这一步解决"程序能不能看见你的手柄"。USB 或蓝牙连上手柄后启动 AntiMicroX，主界面顶部会出现设备下拉框——能看到控制器名称（如"Logitech Dual Action"）就说明识别成功。

主界面就是手柄转键盘的主工作台：左侧是左摇杆和方向键区域，右侧是 A/B/X/Y、肩键、扳机与 Start/Select 的映射格。看图重点看顶部下拉框和底部一排 Sets 标签页，后面会用到。识别不到设备时，先跳过，最后"常见症状"一节有自查方法。

给手柄按键指定键盘映射

这一步解决"按 A 键，屏幕上该发生什么"。操作方式很统一：点一下界面上的映射格，再按你想指定的键盘按键，格子立刻显示按键名；想取消就选 [NO KEY]。每个格子除了键盘键，还能选鼠标点击或触发脚本。

按按键类型给你一套通用起点：

这是深色主题下的同一界面。看图重点看 A/B/X/Y 各格已填入的按键名——空格、回车、B、T 就是这套方案的映射结果；格子里显示 [NO KEY] 的表示未启用。

手柄宏设置：一个手柄键顶一串操作

这一步解决"一次按键完成一串动作"。在映射格里右键（或点选后打开）Advanced 窗口，左侧标签从 Assignments 切到宏编辑，就能给这一个按键排队一串输入：

1. 点 Insert 插入一个空槽位，选键盘键、鼠标键或脚本；
2. 用 Join 把多个槽位拼成同一时刻触发，用 Split 拆成先后顺序；
3. 用 Time 行给每个槽位设延迟（图中示例为 0m 2.30s 的间隔），控制连招节奏；
4. 左侧还有 Toggle（按住切换）和 Turbo（自动连发）标签，适合长按自动触发。

看图重点看右侧 Insert / Join / Split / Delete 一排按钮和下方的 Time 延迟设置——格斗游戏的"轻+重+技能"连招，就是靠这几样排出来的。

摇杆校准步骤：消灭漂移和回中不准

这一步解决"摇杆没推，角色却自己走"。打开 Options 菜单选 Calibration，按向导操作：

1. 保持摇杆松手，点 Start second step；
2. 缓慢把摇杆推到上、下、左、右各方向的最大幅度；
3. 松开摇杆回到中心，点 Save 保存。

看图重点看左侧圆盘：绿色区域是校准后的有效范围，中间红圈就是死区（摇杆中间不触发的小范围），下方 Axis 3 / Axis 4 读数归零说明回中正常。轻微漂移先调大死区，明显偏移就重做一遍校准。

为不同游戏保存独立映射方案

这一步解决"一个方案服务不了所有游戏"。主界面底部那一排标签就是 Sets（配置集）：

1. 点左下角 Sets 下拉新增一组，每游戏一套；
2. 用右下角 Names 按钮给配置集起名，如"模拟器""FPS"；
3. 切游戏时点标签页即可整套切换，互不干扰；
4. 进阶玩家可配 Auto Profile：给指定应用窗口指定方案，切到该窗口自动生效（Wayland 下此功能受限）。

配置备份同样方便：Linux 在~/.config/antimicrox/，Windows 在%APPDATA%\antimicrox\，核心是antimicrox.xml及其旁边的 Auto Profile 文件。整个目录拷到 U 盘或云盘，换机粘贴即可还原；XML 是纯文本，丢进 Git 做版本管理也没问题。

常见症状：没识别、漂移、映射不生效

三个最典型的毛病，按"看到什么 → 为什么 → 怎么办"说。

手柄不在下拉框里。多半是系统层面就没认出设备：Linux 终端跑lsusb（蓝牙手柄用ls /dev/input/js*）确认设备在不在；确认了还看不到，换个 USB 口、重启程序，Flatpak 用户在 Wayland 下可能还需要按官方 wiki 的 uinput 修复处理。

摇杆不推自己动。这是硬件漂移，AntiMicroX 改不了物理问题，但校准加死区能把影响压到最低：重做一遍校准，死区再适当调大；压轴的办法还是清洁或换摇杆模块。

映射了，游戏里没反应。检查 AntiMicroX 是否在游戏之前运行；另一台设备（如 Steam）同时接管手柄时，两边会抢输入，关掉其中一个；映射鼠标操作时，焦点必须在游戏窗口内才生效。

给感兴趣的你

想折腾源码：依赖和编译步骤看 BUILDING.md，贡献流程看 CONTRIBUTING.md；核心代码都在src/下，界面、事件处理、按钮类型、XML 存取分别在src/gui/、src/eventhandlers/、src/joybuttontypes/、src/xml/。想提功能，直接去项目 Issue 区提或给相关 Issue 点个赞同；中文翻译在 Weblate 上维护，对应share/antimicrox/translations/antimicrox_zh_CN.ts。

现在就做三件事：插上手柄确认下拉框认得它；给 A 和 B 各配一个按键；跑一遍摇杆校准。卡在哪一步，把症状和你的配置贴到 Issue 区，顺手把调好的方案分享出来。

【免费下载链接】antimicroxGraphical program used to map keyboard buttons and mouse controls to a gamepad. Useful for playing games with no gamepad support.项目地址: https://gitcode.com/GitHub_Trending/an/antimicrox