vs code 的 screencast mode 是内置功能,无需插件;按 ctrl+shift+p(macos 为 cmd+shift+p),输入 toggle screencast mode 并回车即可开启或关闭,仅在编辑器区域生效,支持自定义按键显示位置、大小及鼠标高亮。

怎么打开 Screencast Mode?别搜插件,它是内置功能
VSCode 的 Toggle Screencast Mode 是原生支持的,不用装任何扩展。按 Ctrl+Shift+P(macOS 是 Cmd+Shift+P),输入 Toggle Screencast Mode 回车即可开启。再执行一次就关闭。注意:不是“Screencast”拼错成 “Screen Cast” 或 “Sceen”,大小写不敏感但空格和词根必须对。
为什么按键没显示?常见三类失效原因
开启后键盘操作仍无浮窗提示,大概率是以下情况之一:
- 你正在终端(Terminal)或设置页(Settings)里按快捷键——
Screencast Mode只在编辑器区域(editorTextFocus)生效,其他面板不触发 - 开启了 Vim 插件且处于 Normal 模式:Vim 会劫持所有按键事件,导致 VS Code 原生录屏逻辑收不到原始输入;临时禁用 Vim 插件或切到 Insert 模式再试
- 系统级热键拦截:比如某些远程桌面工具、录屏软件(OBS、Bandicam)或 macOS 的“辅助功能→键盘→粘滞键”会吞掉组合键,建议关闭后再测试
如何调出按键样式?改 screencast 相关设置项
按 Ctrl+, 打开设置,搜索 screencast,你会看到几个关键配置项:
-
screencast.fontSize:默认14,太小看不清可调大(如18) -
screencast.position:可选top/bottom,默认bottom;教学视频常设为top避免遮挡状态栏信息 -
screencast.showKeyStrokes:控制是否显示按键(true/false),关了就只剩鼠标涟漪 -
screencast.showMousePosition:控制是否高亮鼠标点击位置,false 就只显键位
这些设置都支持工作区级覆盖,但不推荐写进 .vscode/settings.json——因为录屏是临时行为,全局开关更合理。
录制时鼠标点不中?注意焦点与缩放干扰
开启 Screencast Mode 后,鼠标涟漪动画依赖准确的坐标计算,以下两点容易被忽略:
- VSCode 窗口不能是缩放状态(比如 Windows 的 125% 缩放或 macOS 的“更大字体”模式),否则涟漪中心会偏移;建议录制前将系统缩放设为 100%
- 如果用了多显示器且主屏分辨率不一致,确保 VS Code 窗口完全落在主显示器内,跨屏拖动后可能丢失鼠标定位精度
- 部分全屏化工具(如 Rectangle、Magnet)或窗口管理插件会篡改窗口尺寸逻辑,导致涟漪扩散起点错位
最稳的做法:录制前关掉所有窗口管理类插件,用原生全屏(F11)而非最大化,再开 Screencast Mode。











