VSCode 光标样式由 editor.cursorStyle 控制,合法值为 line(默认竖线)、block(方块)、underline(下划线);需同时检查终端光标、cursorWidth、cursorBlinking 及远程扩展干扰。

光标样式在 VSCode 里叫 cursorStyle,不是靠插件或主题改的
VSCode 默认用的是“线性光标”(也就是竖线),但很多人一打开发现是块状或下划线——这通常是因为系统级设置、终端集成、或者被某个扩展/设置意外覆盖了。改回来的关键不是找主题,而是直接控制 cursorStyle 这个配置项。
它有三个合法值:line(竖线)、block(方块)、underline(下划线)。默认就是 line,但如果你看到的是别的,大概率是本地设置了别的值。
- 打开设置(
Ctrl+,或Cmd+,)→ 搜cursorStyle - 点右边铅笔图标,选
line;或者直接编辑settings.json,加这一行:"editor.cursorStyle": "line"
- 改完不用重启,立刻生效
为什么改了 cursorStyle 还是方块?检查终端和内联终端
VSCode 有两个“光标”:编辑器里的和终端里的。你改的是编辑器光标,但如果你常在内置终端(Ctrl+`)里敲命令,它的光标由终端仿真器控制,和编辑器无关。终端里看到方块,不代表编辑器也错了。
- 编辑器光标看的是
editor.cursorStyle - 终端光标看的是
terminal.integrated.cursorStyle,默认是block,要改就设成line或underline - 某些终端主题(比如
PowerShell或zsh配置)会在 shell 启动时强制设光标形状,这时 VSCode 设置无效
cursorWidth 和 cursorBlinking 是配套参数,别漏掉
只设 cursorStyle 不够细。比如你想要更醒目的竖线,可以加宽;不想它闪来闪去干扰注意力,就关掉闪烁。这两个参数经常被忽略,但直接影响使用体感。
-
"editor.cursorWidth": 2—— 默认是0(自动),设成2或3让竖线更粗,尤其适合高分屏 -
"editor.cursorBlinking": "solid"—— 可选值还有blink(默认)、smooth、phase、expand;设成solid就完全不闪 - 注意:
cursorBlinking设为none是无效值,会回退到默认blink
远程开发或 WSL 下光标异常,优先查 remote.extensionKind
用 Remote-SSH 或 WSL 时,有些扩展(比如旧版 Bracket Pair Colorizer 或某些代码高亮增强工具)会注入自己的光标渲染逻辑,强行覆盖 cursorStyle。这不是 bug,是它们 hook 了编辑器底层。
- 临时禁用所有扩展,再开一个文件测试光标是否回归
line - 逐个启用,观察哪一个是“罪魁祸首”
- 确认后,在
settings.json中限制它不在远程运行:"remote.extensionKind": { "username.ext-name": ["ui"] },把workspace去掉
光标这种基础交互,越靠近底层越容易被多层覆盖;真正起效的往往不是“怎么设”,而是“谁在偷偷改”。











