环境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 需要否则连不上 PSGalleryInstall-Module会静默失败PowerShell 7 直接跑第二行。然后重启 VSCode / 新开终端验证(Get-ModulePSReadLine).Version输出2.4.x即成功黑块消失。 下面是完整排查过程。三、排查过程踩坑实录1. 以为是光标样式问题 ❌一开始把cursorStyle改成line、开启cursorBlinking空闲时确实是竖线了但输入时又变回方块terminal.integrated.cursorStyle:line,terminal.integrated.cursorBlinking:true无效。又尝试在 PowerShell profile 里用转义序列DECSCUSRCSI 6 q在每次 prompt 刷新时强制设置竖线光标functionglobal:prompt{[Console]::Write(e[6 q)PS$($executionContext.SessionState.Path.CurrentLocation)$(*($nestedPromptLevel1)) }结果回车后prompt 重绘是竖线但输入过程中按空格/删除依然变方块——prompt 钩子只管提示符显示管不到 PSReadLine 行编辑期间的渲染。这条路走不通。2. 确认是字符渲染问题 ✅静下心观察黑块其实是空格位置显示的黑块占位符——那个空格字符被渲染成了方块。这指向两个方向输入的是全角空格U3000中文输入法全角模式状态栏●按空格输入的就是全角空格终端默认字体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,ModuleBaseName Version ModuleBase ---- ------- ---------- PSReadline 2.0.0 C:\Program Files\WindowsPowerShell\Modules\PSReadline\2.0.02.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 直接执行上面命令大概率静默失败装完用户级目录里还是空的因为三个前置条件没满足TLS 1.2PS 5.1 默认用 TLS 1.0/1.1连不上 PSGallery它要求 TLS 1.2PSGallery 源可能未注册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,ModuleBaseName 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即成功。此时按空格、按删除黑块消失。✅五、同类现象的快速区分终端里出现黑块先分清是哪一种别像我一样先折腾半天光标现象原因解法光标本身是粗黑方块输入覆盖后面字符光标样式 / 覆盖模式cursorStyle: line或按 Insert 退出覆盖模式按空格/删除时出现黑块改光标样式无效PSReadLine 旧版ConPTY 渲染 bugInstall-Module PSReadLine -Force升级特定字符如全角空格显示为□字体缺少字形终端字体加中文字体兜底terminal.integrated.fontFamily: Consolas, Microsoft YaHei, monospace补充中文输入法全角模式状态栏●按空格会输入全角空格 U3000在无中文字体兜底的终端里显示为方块——日常输入用ShiftSpace切回半角。六、小结遇到终端黑块先区分是光标问题还是字符渲染问题方向错了会白折腾VSCode 终端本质是 ConPTY 终端黑块的高频根因PSReadLine 版本太旧Windows PowerShell 5.1 升级模块记得先配 TLS 1.2 PSGallery NuGet否则Install-Module静默失败升级后重启终端才生效七、测试环境项目版本/说明操作系统WindowsVSCode 安装于D:\software\Microsoft VS Code终端VSCode 集成终端基于 ConPTY默认 ShellWindows PowerShell 5.1PSReadLine修复前2.0.0系统级C:\Program Files\WindowsPowerShell\ModulesPSReadLine修复后2.4.5用户级Documents\WindowsPowerShell\Modules\PSReadLine\2.4.5VSCode 主题Visual Studio Light浅色黑块在黑背景下更显眼