Console corruption on Unix PTYs when completion wraps near bottom row (stale _initialY drift)
还没有人认领这个 Issue。
评估
调研方向
Reproduce the completion wrapping scenario with an 80x24 Unix PTY, then read Render.cs and the redraw path around SetCursorPosition(_initialX, _initialY). Compare renders as candidates wrap, scroll, and shrink. Done means cycling completions no longer overwrites prior command history and the prompt remains correctly positioned after terminal scrolling.
由索引模型根据 Issue 内容生成。
描述
Environment
PS version: 7.4.19
PSReadline version: 2.3.6
os: Linux localhost 6.1.141-android14-11-o-gf61012bbfa24 #1 SMP PREEMPT Mon Aug 10 12:44:35 UTC 2026 aarch64 Android
PS file version: 7.4.19.0
HostName: ConsoleHost
BufferWidth: 80
BufferHeight: 24
Exception report
N/A (no crash or exception thrown; visual/screen corruption occurs).
Steps to reproduce
- In a terminal with standard dimensions (e.g. 24 rows, 80 columns), run several commands (e.g.
1..15 | ForEach-Object { "line $_" }) so that output fills the screen and the prompt sits at or near the bottom row. - Type a command with long paths or multiple completion candidates (e.g.
Get-ChildItem /data/data/com.termux/files/usr/or deep directories). - Press
Tabto cycle completions so that completion candidates expand across multiple physical lines and wrap past the bottom row. - Continue pressing
Tabto cycle through candidates of varying lengths (wrapping and unwrapping).
Expected behavior
When completions wrap across multiple lines at the bottom of the screen, the terminal should scroll naturally and continue drawing downward into new lines without overwriting prior console history.
Actual behavior
As Tab cycles between candidates of different lengths:
- Writing past the bottom row forces the terminal emulator to physically scroll lines upward.
- Redrawing the prompt and candidate appears to calculate against the pre-scroll prompt anchor (
_initialY), emitting absolute ANSI cursor coordinates (\e[row;colH) that land above the actual prompt position. - The prompt and new input progressively walk up the screen, drawing directly on top of earlier command outputs and history.
- The screen remains corrupted until cleared with
Clear-Host/cls.
Root cause analysis / Technical notes
On Unix-like platforms (.NET Core PTY), Console.BufferHeight equals Console.WindowHeight. When a multi-line input forces the terminal to scroll lines upward:
- Physical lines shift up into the terminal emulator's scrollback buffer.
- In
Render.cs, redraws position the cursor using absolute coordinates viaSetCursorPosition(_initialX, _initialY). - When subsequent renders are shorter (or when cycling between long and short completion candidates), positioning to
_initialYplaces the cursor over earlier content that shifted into that row slot. - Unix shells (GNU Readline, ZLE, Fish) avoid this by navigating relatively (
\e[A,\e[B,\r) rather than using absolute row addressing.
- 主要语言
- C#
- 星标
- 4.4k
- 派生
- 341
- PR 合并指标
- 30 天内没有已合并 PR
环境准备
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
PowerShell/PSReadLine 的其他 Issue
-
Needs-Triage :mag:
难度 2/5 1-3 小时 新手友好度 78/100
PowerShell/PSReadLine#5205 ·
-
Needs-Triage :mag:
难度 2/5 1-3 小时 新手友好度 68/100
PowerShell/PSReadLine#5195 ·
-
Needs-Triage :mag:
难度 2/5 1-3 小时 新手友好度 72/100
PowerShell/PSReadLine#5121 ·
-
Needs-Triage :mag:
难度 2/5 1-3 小时 新手友好度 64/100
PowerShell/PSReadLine#5045 ·
-
Area-CommandHelp Issue-Enhancement
难度 1/5 1 小时以内 新手友好度 68/100
PowerShell/PSReadLine#3470 · 3 个 reaction ·
查看 PowerShell/PSReadLine 的全部 Issue
相似的 Issue
-
agentic-workflows area/Docs partner/agentic-workflows
难度 2/5 1-3 小时 新手友好度 68/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
microsoft/fluentui-blazor#5364 ·
维护者通常 1 天内回复
-
.NET triage
难度 2/5 1-3 小时 新手友好度 74/100
microsoft/agent-framework#8811 ·
维护者通常 1 天内回复
-
.NET Docs
难度 1/5 1 小时以内 新手友好度 82/100
getsentry/sentry-dotnet#5637 · 1 条评论 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 78/100
QuantConnect/Lean#9842 ·
维护者通常 1 天内回复