Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Console corruption on Unix PTYs when completion wraps near bottom row (stale _initialY drift)

Offen
  • Stimmt etwas nicht?
#5,217 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
48/100
Issue-Typ
Bug
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
csharp
Bereich
cli

Rechercherichtung

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.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Needs-Triage :mag:

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

  1. 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.
  2. Type a command with long paths or multiple completion candidates (e.g. Get-ChildItem /data/data/com.termux/files/usr/ or deep directories).
  3. Press Tab to cycle completions so that completion candidates expand across multiple physical lines and wrap past the bottom row.
  4. Continue pressing Tab to 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:

  1. Physical lines shift up into the terminal emulator's scrollback buffer.
  2. In Render.cs, redraws position the cursor using absolute coordinates via SetCursorPosition(_initialX, _initialY).
  3. When subsequent renders are shorter (or when cycling between long and short completion candidates), positioning to _initialY places the cursor over earlier content that shifted into that row slot.
  4. Unix shells (GNU Readline, ZLE, Fish) avoid this by navigating relatively (\e[A, \e[B, \r) rather than using absolute row addressing.
Vorherrschende Sprache
C#
Sterne
4.4k
Forks
341
Keine gemergten PRs in 30 T.

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus PowerShell/PSReadLine

Alle Issues in PowerShell/PSReadLine

Ähnliche Issues

Weitere Issues zu C#

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.