• 开篇：那个“你按的是啥？”的尴尬瞬间
• 主角登场：Keyviz 是个啥？
• 快速上手：三分钟把它装到你电脑上
• Windows 用户
• macOS 和 Linux 用户
• 深度“把玩”：让 Keyviz 听你的话
• 通用设置 (General)
• 风格定制 (Style)
• 外观与动画 (Appearance)
• 一个普通程序员的碎碎念
• 总结

大家好，我是《善忘技术夹》的老朋友。今天不说代码，聊个能提升我们程序员生产力和“表现力”的小工具。

开篇：那个“你按的是啥？”的尴尬瞬间

不知道大家有没有经历过这样的场景：

你在跟同事远程结对编程，IDE 里的光标飞舞，一顿 Ctrl + Shift + F 全局搜索，Alt + Enter 智能修正，Ctrl + Alt + L 格式化代码，行云流水，自我感觉帅得不行。结果，屏幕另一头的同事弱弱地问了一句：“等会儿…你刚才按的是啥快捷键，怎么一下就跳到定义了？”

或者，你在给团队做技术分享，演示一个新工具或者新框架。你一边讲解，一边熟练地敲着各种命令和快捷键。讲完之后，你以为大家都会为你精彩的演示鼓掌，结果台下有同学举手：“老师，您刚才那个窗口是怎么分屏的？按了什么键？”

这种时候，我们的“流”就被打断了。高效的肌肉记忆，在知识传递的这一刻，反而成了一种沟通障碍。因为我们的操作对于观众来说是完全不可见的。这种不断的打断和解释，不仅影响了我们自己的思路，也让观众的体验大打折扣。说白了，这就是一个在我们技术交流中常见的“沟通瓶颈”。

为了解决这个痛点，我找了不少工具，今天就要给大家安利一款我最近发现的“神器”——Keyviz。

主角登场：Keyviz 是个啥？

简单来说，Keyviz 就是一个免费、开源的桌面小工具，它的作用只有一个：实时地在屏幕上显示你按下的键盘按键和鼠标操作 2。

当你进行屏幕录制、直播、技术演示或者在线协作时，它能清清楚楚地告诉你的观众，你按下了 Ctrl + C 还是 Ctrl + V，是单击了鼠标左键还是右键拖拽 3。

最关键的是它有几个特别吸引我们程序员的点：

1. 完全免费和开源：这是最重要的。作为一个需要获取键盘和鼠标输入的工具，安全性是我们最关心的。Keyviz 基于 GPL-3.0 许可证开源，代码全在 GitHub 上，任何人都可以去审查，不用担心它是个键盘记录器。这点对于打消一些用户的安全顾虑至关重要，比如有些论坛上就有用户表示对闭源工具有所怀疑。
2. 跨平台支持：无论你的主力机是 Windows、macOS 还是 Linux，Keyviz 都能用，这对成员操作系统不统一的团队来说非常友好 。
3. 颜值高，可定制性强：默认的显示效果就很不错，而且提供了非常丰富的自定义选项，可以让你把它调教成你最喜欢的样子。

快速上手：三分钟把它装到你电脑上

把 Keyviz 装到电脑上非常简单，开发者考虑到了不同用户的使用习惯，提供了多种安装方式。

Windows 用户

对于大部分 Windows 用户，最直接的方式就是去它的 GitHub Releases 页面下载。

• 官方网站: https://mularahul.github.io/keyviz/
• GitHub 地址:(https://github.com/mulaRahul/keyviz)

在 Releases 页面，你会看到两种文件：

• keyviz-vX.X.X.exe：这是安装版，下载后双击安装，一路“下一步”就行了。
• keyviz-vX.X.X-portable.zip：这是便携版，解压后直接运行，不需要安装，很适合不喜欢把软件装得到处都是的同学。

当然，如果你是喜欢用包管理器的“高玩”，Keyviz 也提供了支持：

• Winget: winget install mulaRahul.Keyviz
• Scoop: scoop bucket add extras 然后 scoop install keyviz

此外，你也可以直接在微软应用商店里搜索 Keyviz 进行安装。

macOS 和 Linux 用户

Keyviz 同样为这两个平台提供了安装包。

• macOS 用户：下载对应的 .dmg 文件安装即可。但有一点需要特别注意，macOS 的安全策略比较严格，你需要手动为 Keyviz 开启权限。打开“系统设置” -> “隐私与安全性”，然后在“辅助功能”和“输入监听”里都把 Keyviz 添加进去并勾选。这是这类软件在 macOS 上运行的必要步骤。
• Linux 用户：开发者提供了 .deb 和 .rpm 格式的安装包，根据你的发行版选择对应的包进行安装就行了。

深度“把玩”：让 Keyviz 听你的话

安装好并运行后，你会在系统托盘区看到 Keyviz 的图标。右键点击图标，选择“Settings”，就可以打开它的设置界面，开始你的“调教”之旅了。它的设置界面非常直观，主要分为几个部分。

通用设置 (General)

这里有几个核心功能，强烈建议大家好好看看：

• Filter normal keys：这个选项默认是开启的，它的作用是“只显示快捷键，过滤普通按键”。这是 Keyviz 的精髓所在！开启后，你打字聊天、写代码时的普通字母、数字就不会显示在屏幕上，只有当你按下

Ctrl、Alt、Shift、Cmd 等修饰键组合的快捷键时，它才会显示出来。这样就极大地保证了画面的整洁，观众的注意力会集中在关键操作上。

• Linger：这个设置项决定了按键提示在屏幕上“停留”多久，单位是秒。如果你是在做一个快节奏的演示，可以设置短一点，比如 2-3 秒。但如果你是在录制教学视频，我建议设置长一点，比如 5-6 秒，这样能确保观众有足够的时间看清楚你按下的组合键。

风格定制 (Style)

这个面板就是 Keyviz 的“美颜相机”，你可以尽情发挥，把它打扮得漂漂亮亮。

这里你可以定制几乎所有视觉元素 3：

• Keycap Style：提供了几种不同的按键风格，比如“极简风”、“立体风”和“机械键盘风” 6。我个人比较喜欢“Elevated”（立体风），看起来比较有质感。
• Colors：你可以分别设置普通按键和修饰键（Modifier Keys）的背景色和文字颜色。这里我有个小技巧分享给大家：把修饰键的颜色设置得更醒目一些，比如背景用蓝色，这样在演示 Ctrl + Shift + T 这种复杂快捷键时，观众能一眼就看出哪些是功能键。
• Size, Border, etc.：还可以调整按键的大小、边框、图标等等。

这些丰富的自定义选项，不仅仅是为了好看。它实际上赋予了演示者一种“信息设计”的能力。通过合理的配置，我们可以把观众的注意力引导到我们希望他们关注的操作上，从而实现更清晰、更高效的知识传递。

外观与动画 (Appearance)

这里主要控制按键提示出现的位置和动效。

• Alignment & Margin：你可以决定让提示出现在屏幕的哪个位置，比如左下角、顶部居中等等，还可以微调边距，确保它不会遮挡你演示软件的重要内容 3。
• Animation：提供了几种不同的出现和消失的动画效果，比如“淡入淡出”、“缩放”等 8。加一点合适的动画，能让你的录屏或者演示看起来更专业、更精致。

一个普通程序员的碎碎念

作为一个普通的程序员，在体验了 Keyviz 之后，还有一些想和大家分享的“碎碎念”。

首先，我真的很佩服这个软件的开发者 Rahul Mula 。他一个人做出了这么一个精致、实用还跨平台的工具，并且完全免费地分享给社区。在 GitHub 上，这个项目已经获得了超过 8300 个 star ，这足以证明它的受欢迎程度。如果你觉得这个工具对你有帮助，不妨去 GitHub 给它点个 star，或者通过项目主页的捐赠渠道支持一下开发者 。

其次，我注意到这个软件是用 Flutter/Dart 开发的 。可能有些同学会觉得用 Flutter 来做桌面端有点“非主流”，甚至有人在论坛上表示这很“奇怪” 。但仔细想想，这其实是一个非常聪明的选择。对于独立开发者来说，Flutter 能够用一套代码库同时构建出 Windows、macOS 和 Linux 的应用，极大地提高了开发效率，这正是它能实现跨平台的关键。

当然，Keyviz 也不是完美的。根据一些用户的反馈，它在某些游戏（比如 Minecraft）中可能无法正确检测按键，并且大家期待已久的多显示器支持功能也还在开发计划中 。但好消息是，开发者对这些反馈是知晓的，并且项目也在持续迭代中，这正是一个健康的开源项目的表现。

有个很有意思的事情是，Keyviz 这个工具做得太好了，以至于在微软官方的 PowerToys 项目的 GitHub issue 里，都有用户在请求增加类似功能时，直接拿 Keyviz 来当做范例 1。这可以说是来自社区的最高级别的认可了。

对了，还有一个对国内用户特别友好的信息：GitHub 上已经有热心开发者创建了 Keyviz 的中文汉化分支 ，如果你对英文设置界面感到困扰，可以去搜索一下。

为了让大家对这类工具有个更全面的认识，我简单对比了市面上几款主流的按键显示工具：

这个表格清晰地展示了 Keyviz 的定位：它是目前市面上功能最全面、支持平台最广的免费开源解决方案。对于绝大多数开发者和内容创作者来说，它都是不二之选。

总结

总而言之，Keyviz 是一款小而美的工具，它精准地解决了我们在演示和教学场景下的一个核心痛点。它免费、开源、跨平台、功能强大且高度可定制。无论你是需要录制教程的UP主，还是经常需要给同事演示代码的程序员，又或者是在线的技术讲师，Keyviz 都能成为你的得力助手。

强烈推荐大家去下载一个试试，相信我，一旦你用上它，就再也回不去了。

• 官方网站: https://mularahul.github.io/keyviz/
• GitHub 地址:(https://github.com/mulaRahul/keyviz)