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 天內回覆