环境：Windows + PowerShell 5.1 + VSCode 集成终端（ConPTY）
状态：已解决（PSReadLine 2.0.0 → 2.4.5）

一、问题现象

在 VSCode 的集成终端（PowerShell）里输入命令时：

• 光标是黑色方块，看起来就是个"黑块"
• 按空格、按删除时，光标处出现黑色方块
• 把光标样式改成竖线（terminal.integrated.cursorStyle: "line"）后，空闲时是竖线，但一按空格/删除又变回黑块

如果你也遇到一模一样的情况，而且怎么改光标样式都压不住——这不是光标设置问题，是 PSReadLine 的锅。

二、快速解决（TL;DR）

终端黑块十有八九是PSReadLine 版本太旧（2.0.x），升级即可：

[Net.ServicePointManager]::SecurityProtocol =[Net.ServicePointManager]::SecurityProtocol-bor[Net.SecurityProtocolType]::Tls12Install-ModulePSReadLine-Force

说明：第一行只在 Windows PowerShell 5.1 需要（否则连不上 PSGallery，Install-Module会静默失败）；PowerShell 7 直接跑第二行。

然后重启 VSCode / 新开终端，验证：

(Get-ModulePSReadLine).Version

输出2.4.x即成功，黑块消失。👇 下面是完整排查过程。

三、排查过程（踩坑实录）

1. 以为是光标样式问题 ❌

一开始把cursorStyle改成line、开启cursorBlinking，空闲时确实是竖线了，但输入时又变回方块：

"terminal.integrated.cursorStyle":"line","terminal.integrated.cursorBlinking":true

无效。又尝试在 PowerShell profile 里用转义序列（DECSCUSR，CSI 6 q）在每次 prompt 刷新时强制设置竖线光标：

functionglobal:prompt{[Console]::Write("`e[6 q")"PS$($executionContext.SessionState.Path.CurrentLocation)$('>'*($nestedPromptLevel+1)) "}

结果：回车后（prompt 重绘）是竖线，但输入过程中（按空格/删除）依然变方块——prompt 钩子只管提示符显示，管不到 PSReadLine 行编辑期间的渲染。这条路走不通。

2. 确认是"字符渲染"问题 ✅

静下心观察：黑块其实是空格位置显示的黑块占位符——那个"空格"字符被渲染成了方块。这指向两个方向：

• 输入的是全角空格（U+3000）：中文输入法全角模式（状态栏●）按空格输入的就是全角空格，终端默认字体（Consolas）没有它的字形，渲染成□
• 终端渲染管线问题：某些字符/光标状态在特定字体和渲染组合下显示为黑块

3. 微软官方文档一锤定音 ✅

Windows Terminal 官方文档 Troubleshooting 页面里有一条：

“My colors look strange, there are black bars on my screen” —— 在 Windows Terminal / ConPTY 终端中，旧版PSReadLine会导致渲染异常（黑条/黑块），解决方案是更新 PSReadLine。

链接：https://learn.microsoft.com/windows/terminal/troubleshooting#my-colors-look-strange-there-are-black-bars-on-my-screen

检查本机版本：

Get-Module-ListAvailable PSReadLine|SelectName,Version,ModuleBase

Name Version ModuleBase ---- ------- ---------- PSReadline 2.0.0 C:\Program Files\WindowsPowerShell\Modules\PSReadline\2.0.0

2.0.0—— 老得不能再老。Windows PowerShell 5.1 自带的 PSReadLine 2.0.0 在 ConPTY 下就是有这个渲染 bug。元凶找到。

四、解决方案：升级 PSReadLine

核心就一条命令：

Install-ModulePSReadLine-Force

装到当前用户作用域（默认），不动系统目录，且用户级目录在模块搜索路径（PSModulePath）里排第一位，新开的终端必然优先加载新版。

踩坑：PS 5.1 直接 Install-Module 会失败

Windows PowerShell 5.1 直接执行上面命令，大概率静默失败（装完用户级目录里还是空的），因为三个前置条件没满足：

1. TLS 1.2：PS 5.1 默认用 TLS 1.0/1.1，连不上 PSGallery（它要求 TLS 1.2）
2. PSGallery 源：可能未注册
3. NuGet provider：可能未安装

完整可执行版本：

# 1) 启用 TLS 1.2（关键！）[Net.ServicePointManager]::SecurityProtocol =[Net.ServicePointManager]::SecurityProtocol-bor[Net.SecurityProtocolType]::Tls12# 2) 注册 PSGallery（若未注册）if(-not(Get-PSRepository-Name PSGallery-ErrorAction SilentlyContinue)){Register-PSRepository-Default}# 3) 安装 NuGet providerif(-not(Get-PackageProvider-Name NuGet-ErrorAction SilentlyContinue)){Install-PackageProvider-Name NuGet-Force-Scope CurrentUser-Confirm:$false}# 4) 安装最新 PSReadLine 到用户级目录Install-ModulePSReadLine-Force-Scope CurrentUser-AllowClobber-Confirm:$false

验证

安装后检查版本：

Get-Module-ListAvailable PSReadLine|SelectName,Version,ModuleBase

Name Version ModuleBase ---- ------- ---------- PSReadLine 2.4.5 D:\...\Documents\WindowsPowerShell\Modules\PSReadLine\2.4.5 PSReadline 2.0.0 C:\Program Files\WindowsPowerShell\Modules\PSReadline\2.0.0

重启 VSCode（或新开一个终端），在终端里确认当前会话加载的版本：

(Get-ModulePSReadLine).Version

输出2.4.5即成功。此时按空格、按删除，黑块消失。✅

五、同类现象的快速区分

终端里出现"黑块"，先分清是哪一种，别像我一样先折腾半天光标：

补充：中文输入法全角模式（状态栏●）按空格会输入全角空格 U+3000，在无中文字体兜底的终端里显示为方块——日常输入用Shift+Space切回半角。

六、小结

• 遇到终端黑块，先区分是"光标"问题还是"字符渲染"问题，方向错了会白折腾
• VSCode 终端（本质是 ConPTY 终端）黑块的高频根因：PSReadLine 版本太旧
• Windows PowerShell 5.1 升级模块，记得先配 TLS 1.2 + PSGallery + NuGet，否则Install-Module静默失败
• 升级后重启终端才生效

七、测试环境