MouseTrap：多显示器不同 DPI 光标映射工具 #

MouseTrap 是什么？ #

MouseTrap 是一款运行在 Windows 上的轻量级桌面小工具，专门用于在分辨率与缩放设置不同的多台显示器之间精确映射鼠标光标位置。

Windows 系统按“逻辑像素”拼接多台显示器，当主屏是 4K、副屏是 1080p，或两块屏幕的缩放比例不一致时，鼠标从一块屏幕移到另一块屏幕，光标往往不会出现在你预期的物理对应位置，而是出现“跳变”或明显错位。MouseTrap 的思路是让用户以显示器真实的物理尺寸为基准，在屏幕之间手动绘制“屏幕桥接（Screen Bridges）”，从而让光标跨屏移动时保持视觉上的连续与自然。它以系统托盘图标形式常驻运行，配置简单、体积小巧，并采用 MIT 开源协议免费发布，适合双屏、三屏办公以及需要频繁跨屏操作的开发者、设计师与内容创作者。

MouseTrap 有哪些亮点特色？ #

• 按物理尺寸映射光标：以显示器的实际物理尺寸（而非 Windows 的逻辑像素）作为对齐基准，从根源上解决不同分辨率、不同缩放率屏幕之间的光标跳变与错位问题。
• 可视化屏幕桥接配置：在配置界面中点击 “+” 按钮即可在相邻显示器之间添加桥接，拖动并调整蓝红色桥接条的大小，使其覆盖你希望鼠标跨越的区域，所见即所得，且支持保存前先行测试。
• 托盘常驻、右键即用：程序运行后常驻任务栏右下角系统托盘，右键图标即可打开设置（Settings）、开关鼠标传送（Mouse teleportation）或完全退出（Exit），不占用桌面空间。
• 一键关闭鼠标传送：菜单中的 “Mouse teleportation” 复选框可临时关闭光标映射功能，官方特别说明这在全屏游戏时非常实用，避免映射逻辑干扰游戏操作。
• 内置诊断与日志工具：自 v1.0.6 起提供诊断窗口（Diagnostic Window）、实时日志查看器（Realtime Log Viewer）、配置查看器（Configuration Viewer）与日志文件查看器（LogFile Viewer），出问题时排查更方便。
• 开机自动启动：设置界面左侧的复选框可让 MouseTrap 随 Windows 启动自动运行，重启电脑后无需手动打开，配置持续生效。
• 命令行重新初始化：在命令行执行 mousetrap --reinit 即可触发重新初始化，无需退出并重开程序。
• 开源免费（MIT 协议）：源码托管于 GitHub，采用 MIT 许可证，可自由查看、修改与分发，仓库同时提供 Issues 反馈渠道。

免费下载 MouseTrap #

以下为官方提供的 Windows 安装包，点击链接即可下载。

提示：官方最新版本发布页位于 GitHub Releases（Download 链接），下载后请确认系统已安装 .NET 10 Runtime。

MouseTrap 如何使用？ #

1. 启动程序：解压并双击运行 MouseTrap.exe，程序会以图标形式出现在任务栏右下角的系统托盘中。
2. 查看显示器布局：右键点击托盘图标，选择 Settings，进入设置界面。这里会显示你的显示器及其在 Windows 中的相对位置（Windows 并不知道你屏幕的真实物理尺寸）。
3. 配置屏幕桥接：点击 Configure Screen Bridges，在相邻两块显示器之间点击 “+” 按钮添加桥接，然后拖动调整桥接条，使其长度与你显示器的物理尺寸相匹配。蓝红色条应覆盖你希望鼠标指针跨越屏幕的那一段空间，长度按“从红色尖端到红色尖端”的完整尺寸计算。
4. 测试并保存：配置完成后可先测试效果，确认光标移动顺手后再保存。按 ESC 键或点击 Close 按钮退出配置界面。
5. 设置开机自启：如果左侧的自动启动复选框尚未勾选，请勾选它，以保证电脑重启后 MouseTrap 自动运行。
6. 临时关闭映射：玩游戏或进行其他不希望被映射干扰的操作时，右键托盘图标取消勾选 Mouse teleportation 即可；需要时再勾选回来。
7. 命令行重初始化：显示器布局发生变化时，可在命令行执行 mousetrap --reinit 重新加载配置。

MouseTrap 的常见问题？ #

MouseTrap 对系统有什么要求？ 官方给出的最低要求是 Windows 10 Creators Update（Build 1703）或更高版本，并需要 .NET 10 Runtime。如果运行环境缺少运行时，程序在大多数情况下会主动提示你安装。

为什么光标在屏幕之间还是会突然跳一下？ 通常是因为桥接条的长度与实际屏幕物理尺寸不匹配。桥接的尺寸按红色尖端到红色尖端的完整长度计算，需要参照显示器真实尺寸进行调整；调整后建议先在配置界面中测试再保存。此外，v1.0.6 版本已针对社区反馈的“意外光标传送”问题（Issue #2）实现了修复。

玩全屏游戏时鼠标行为异常怎么办？ 右键点击系统托盘中的 MouseTrap 图标，取消勾选 Mouse teleportation，即可临时关闭鼠标传送功能。这是官方推荐的全屏游戏使用方式，游戏结束后再重新勾选即可恢复。

调整了显示器摆放或更换了屏幕，需要重启软件吗？ 可以退出后重新打开，也可以直接在命令行运行 mousetrap --reinit 触发重新初始化，无需完整重启程序。

MouseTrap 是免费的吗？ 是的。项目采用 MIT 开源许可证，完全免费，源码公开在 GitHub 上，可自由使用、修改和分发。

遇到 Bug 或有功能建议怎么办？ 官方在 README 中建议直接到 GitHub 仓库的 Issues 区提交问题，作者会尽力修复。参考社区常见反馈，提交时附上诊断窗口与日志文件中的信息，有助于更快定位问题。

MouseTrap 如何安装？ #

目前 MouseTrap 仅提供 Windows 版本，安装方式非常简单：

1. 确认系统版本：右键“此电脑” → 属性，确认 Windows 版本不低于 Windows 10 Creators Update（Build 1703）。
2. 下载安装包：从上方下载表格获取 MouseTrap-1.0.21.zip，或前往 GitHub 仓库 Releases 页面下载最新版本。
3. 解压文件：将压缩包解压到你希望存放程序的目录（例如 D:\Tools\MouseTrap）。
4. 安装 .NET 10 Runtime：若系统尚未安装 .NET 10 Runtime，请先安装；直接运行程序时若缺失运行时，通常会收到提示。
5. 运行程序：双击 MouseTrap.exe 启动，托盘图标出现即表示启动成功。
6. 设置开机自启：在 Settings 界面勾选左侧复选框，让程序随 Windows 一起启动。
7. 注意事项：自 v1.0.21 起，官方已停止 Chocolatey 支持（该支持在 v1.0.20 引入、v1.0.19 与 v1.0.21 中均被移除），请务必通过 GitHub Releases 或本站提供的压缩包获取程序，不要使用 Chocolatey 源安装。

MouseTrap 如何卸载？ #

MouseTrap 属于免安装的绿色小工具，卸载过程以手动清理为主（官方 README 未提供专门的卸载章节，以下为常规操作步骤）：

1. 退出程序：右键点击系统托盘中的 MouseTrap 图标，选择 Exit 完全结束进程，避免文件被占用。
2. 取消开机自启：如果之前勾选过自动启动，建议先在 Settings 中取消勾选，再执行后续步骤。
3. 删除程序文件：直接删除解压后的程序文件夹（包括 MouseTrap.exe 及相关文件）即可完成主体卸载。
4. 清理残留配置与日志：若此前使用过诊断窗口与日志功能，可在用户目录或程序目录中查找残留的配置文件与日志文件并手动删除（具体路径官网未明确说明，建议先在程序目录内检查）。
5. 可选清理运行时：如果 .NET 10 Runtime 是为 MouseTrap 单独安装且不再有其他程序使用，可在“设置 → 应用 → 已安装的应用”中将其一并卸载。