zsh-autosuggestions: zsh autosuggest kiểu Fish

Gõ lại các lệnh đã từng chạy trong lịch sử shell

Bất kỳ ai dùng Zsh cũng sẽ có lúc gõ lại cùng một chuỗi flag dài của docker run, cùng một lệnh git, hay cùng một hostname ssh hàng chục lần mỗi tuần, và Zsh mặc định chỉ giúp được nếu bạn nhớ bấm Ctrl+R để tìm kiếm. zsh-autosuggestions bỏ qua bước đó. Chỉ cần gõ đủ để khớp với một lệnh đã chạy trước đây, phần còn lại của dòng lệnh sẽ hiện ngay tại chỗ, không cần một giao diện tìm kiếm riêng.

zsh-autosuggestions làm gì

zsh-autosuggestions là một plugin cho Zsh, hiển thị một gợi ý lệnh bằng chữ xám mờ ngay sau con trỏ khi bạn gõ, dựa trên các lệnh khớp trong lịch sử shell hoặc từ completion engine. Plugin yêu cầu Zsh từ bản v4.3.11 trở lên và hoạt động bằng cách gắn vào các widget của Zsh Line Editor (zle) thay vì thay thế prompt hay shell của bạn. Nhấn phím mũi tên phải hoặc End để chấp nhận toàn bộ gợi ý, hoặc dùng forward-word để chấp nhận từng phần.

Tùy chỉnh chiến lược gợi ý và giao diện hiển thị

• ✓Ba chiến lược gợi ý có thể hoán đổi cho nhau — history (lệnh khớp gần nhất trong lịch sử), completion (những gì tab-completion sẽ gợi ý, cần module zpty), và match_prev_cmd (giống history nhưng gắn với lệnh bạn vừa chạy ngay trước đó).
• ✓ZSH_AUTOSUGGEST_STRATEGY nhận vào một mảng, nên bạn có thể nối nhiều chiến lược và rơi xuống chiến lược tiếp theo khi cái đầu không tìm thấy gợi ý nào — ví dụ thử history trước rồi mới đến completion.
• ✓Màu sắc và kiểu hiển thị gợi ý cấu hình được qua ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE (màu chữ, màu nền, bold, underline, standout), không chỉ là bật/tắt đơn thuần.
• ✓Năm mảng widget (CLEAR, ACCEPT, EXECUTE, PARTIAL_ACCEPT, IGNORE_WIDGETS) cho phép bạn cấu hình lại chính xác keybinding zle nào kích hoạt hành vi gợi ý nào.
• ✓ZSH_AUTOSUGGEST_HISTORY_IGNORE và ZSH_AUTOSUGGEST_COMPLETION_IGNORE nhận glob pattern để tắt gợi ý cho một số lệnh cụ thể, ví dụ không bao giờ gợi ý cd * hay completion của git *.
• ✓ZSH_AUTOSUGGEST_BUFFER_MAX_SIZE tắt gợi ý khi buffer vượt quá độ dài quy định, nên dán một đoạn văn bản lớn vào terminal sẽ không kích hoạt tra cứu gợi ý.

Cài đặt plugin

Các bước cài đặt cụ thể không được ghi rõ trực tiếp trong dữ kiện ở đây — README trỏ sang một file INSTALL.md riêng thay vì liệt kê trực tiếp. Điều được ghi rõ: zsh-autosuggestions cần Zsh từ bản v4.3.11 trở lên, và phần Uninstallation của README cho thấy hình dạng của việc cài đặt theo chiều ngược lại — plugin tồn tại dưới dạng một git repository đã clone (ví dụ gỡ cài đặt trong README dùng đường dẫn ~/.zsh/zsh-autosuggestions) và được source từ một dòng trong ~/.zshrc, dòng này sẽ bị xóa cùng với repo khi gỡ cài đặt. Nếu bạn dùng Oh My Zsh, README khuyên nên đặt các override cấu hình ZSH_AUTOSUGGEST_* vào một file trong thư mục $ZSH_CUSTOM thay vì sửa trực tiếp .zshrc, để tránh bị ghi đè khi framework cập nhật.

Chấp nhận và tinh chỉnh gợi ý

Sau khi được source, zsh-autosuggestions hoạt động một cách thụ động: bắt đầu gõ một lệnh và phần còn lại của dòng lệnh sẽ hiện sau con trỏ bằng chữ xám mờ (màu này lấy từ ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE, mặc định là fg=8). Khi con trỏ ở cuối buffer, nhấn mũi tên phải (widget forward-char) hoặc End (end-of-line) sẽ chấp nhận toàn bộ gợi ý và thay nội dung buffer bằng gợi ý đó. Gọi widget forward-word chỉ chấp nhận đến vị trí con trỏ dừng lại — đây là cách lấy gợi ý từng từ một. Ngoài các phím mặc định, plugin còn cung cấp các widget riêng — autosuggest-accept, autosuggest-execute, autosuggest-clear, autosuggest-fetch, autosuggest-disable, autosuggest-enable, và autosuggest-toggle — mà bạn có thể tự bind, ví dụ bindkey '^ ' autosuggest-accept để chấp nhận bằng Ctrl+Space. Nguồn gốc của gợi ý do ZSH_AUTOSUGGEST_STRATEGY quyết định, một mảng được thử lần lượt: history cho lệnh khớp gần nhất, completion cho những gì completion engine gợi ý, hoặc match_prev_cmd cho một match trong lịch sử gắn với lệnh bạn vừa chạy trước đó.

Các lựa chọn autocomplete khác cho zsh

Câu hỏi thường gặp

Trường hợp sử dụng phù hợp nhất

• •Gõ các lệnh dài, hay lặp lại — flag của docker run, lệnh curl kèm header, alias ssh — nơi việc gõ lại cùng một chuỗi là thuần túy phiền toái.
• •Làm việc trong một cấu hình Oh My Zsh có sẵn, vì README hướng dẫn đặt các override ZSH_AUTOSUGGEST_* vào một file trong $ZSH_CUSTOM.
• •Các workflow dùng terminal nhiều, nơi liếc qua một gợi ý màu xám tốt hơn việc ngắt mạch để bấm Ctrl+R.
• •Các thiết lập keybinding tùy biến, vì mỗi hành động accept/clear/execute đều được cung cấp như một widget zle riêng để bạn tự bind.

Ai nên dùng — và ai nên bỏ qua

Bất kỳ ai sống trong terminal và đã quen với việc chỉnh .zshrc đều nên thử zsh-autosuggestions — đây là một plugin nhỏ, chỉ làm một việc, không có dependency nào ngoài Zsh. Bỏ qua nó nếu bạn hiếm khi gõ lại lệnh cũ, hoặc không muốn học thêm một tập biến ZSH_AUTOSUGGEST_* mới mỗi khi cần tinh chỉnh — đặc biệt là chiến lược completion, vốn đòi hỏi bạn hiểu zpty và cấu hình completion hiện có của mình.

Repo liên quan