Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

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

Đang mở
  • Có gì không ổn?
#5,217 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
csharp
Lĩnh vực
cli

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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.
Ngôn ngữ chính
C#
Star
4.4k
Fork
341
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của PowerShell/PSReadLine

Tất cả issue của PowerShell/PSReadLine

Issue tương tự

Thêm issue về C#

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.