<br> <h1>⚒️ Zsh Vi 模式 ⚒️</h1>
</div> <h4 align="center"> 一个用于不可知论的 <a href="https://www.zsh.org/" target="_blank"><code>ZSH</code></a> 插件。 </h4> <p align="center"> <a href="https://github.com/sponsors/jeffreytse"> <img src="https://img.shields.io/static/v1?label=sponsor&message=%E2%9D%A4&logo=GitHub&link=&color=greygreen" alt="捐赠 (GitHub 赞助)" /> </a> <a href="https://github.com/jeffreytse/zsh-vi-mode/releases"> <img src="https://img.shields.io/github/v/release/jeffreytse/zsh-vi-mode?color=brightgreen" alt="发布版本" /> </a> <a href="https://opensource.org/licenses/MIT"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/5a1ba0de-47c1-474e-bf23-4ae1f95d8f01.svg" alt="许可证: MIT" /> </a> <a href="https://liberapay.com/jeffreytse"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/9c677da1-151a-4f3f-97e9-40290bae57d2.svg?logo=liberapay" alt="捐赠 (Liberapay)" /> </a> <a href="https://patreon.com/jeffreytse"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/02ac27ee-b480-4180-8cec-8109447fe6e3.svg?style=flat-square" alt="捐赠 (Patreon)" /> </a> <a href="https://ko-fi.com/jeffreytse"> <img height="20" src="https://www.ko-fi.com/img/githubbutton_sm.svg" alt="捐赠 (Ko-fi)" /> </a> </p> <div align="center"> <h4> <a href="#-features">特性</a> | <a href="#%EF%B8%8F-installation">安装</a> | <a href="#-usage">使用</a> | <a href="#-credits">致谢</a> | <a href="#-license">许可证</a> </h4> </div> <div align="center"> <sub>由 <a href="https://jeffreytse.net">jeffreytse</a> 和 <a href="https://github.com/jeffreytse/zsh-vi-mode/graphs/contributors">贡献者们</a> 以 ❤︎ 构建 </div> <br> <img alt="Zsh Vi-mode 演示" src="https://yellow-cdn.veclightyear.com/835a84d5/25c3278c-e62d-4bb0-a314-f9ddaa8059ef.gif" />也许你曾经体验过 Zsh 的默认 Vi 模式,在开启默认 Vi 模式后,你逐渐发现它存在许多问题,一些功能不完善或不存在,甚至有些行为与原生 Vi(Vim) 模式不同。
尽管默认的 Vi 模式有些尴尬和不愉快,你仍然继续使用它,但在使用一段时间后gradually逐渐失去了兴趣。最终,你失望地放弃了。
你很长一段时间都没有再想起 Vi 模式,直到有一天你偶然发现了这个插件,你读到这里,意识到这个插件就是为了解决上述问题,让你重新爱上 Vi 模式。一个微笑突然出现在你的脸上,就像重获新生。
冬天来了,春天还会远吗?
10p 和 4fa(进行中)。ZSH: >= 5.1.0
在你的 .zshrc 中添加 zsh-vi-mode
antigen bundle jeffreytse/zsh-vi-mode
在你的 .zshrc 中加载 zsh-vi-mode 作为插件
zplug "jeffreytse/zsh-vi-mode"
在你的 .zshrc 中包含加载命令
zgen load jeffreytse/zsh-vi-mode
在你的 .zshrc 中包含加载命令
zinit ice depth=1 zinit light jeffreytse/zsh-vi-mode
注意:使用 depth=1 ice 是可选的,不推荐也不官方支持其他类型的 ice。
将 zsh-vi-mode 克 隆到你的自定义插件仓库
git clone https://github.com/jeffreytse/zsh-vi-mode \ $ZSH_CUSTOM/plugins/zsh-vi-mode
然后在你的 .zshrc 中加载它作为插件
plugins+=(zsh-vi-mode)
请记住,插件需要在 oh-my-zsh.sh 被加载之前添加。
将 zsh-vi-mode 添加到你的插件文件(例如 ~/.zsh_plugins.txt)
jeffreytse/zsh-vi-mode
在你的 .zshrc 中加载 zsh-vi-mode 作为插件
plug "jeffreytse/zsh-vi-mode"
在你的 .zimrc 中加载 zsh-vi-mode 作为插件
zmodule jeffreytse/zsh-vi-mode
对于 Homebrew 用户,你可以通过以下命令安装
brew install zsh-vi-mode
然后在你的 .zshrc(或 .bashrc)中加载它
source $(brew --prefix)/opt/zsh-vi-mode/share/zsh-vi-mode/zsh-vi-mode.plugin.zsh
对于 Arch Linux 用户,可以通过以下命令安装
yay -S zsh-vi-mode
或者安装最新更新版本(不稳定)
yay -S zsh-vi-mode-git
然后在 .zshrc(或 .bashrc)中引用
source /usr/share/zsh/plugins/zsh-vi-mode/zsh-vi-mode.plugin.zsh
对于 Nix 用户,从 e7e3480530b34a9fe8cb52963ec2cf66e6707e15 版本开始,可以通过以下配置引用插件
programs = { zsh = { interactiveShellInit = '' source ${pkgs.zsh-vi-mode}/share/zsh-vi-mode/zsh-vi-mode.plugin.zsh ''; }; };
或者如果你喜欢使用 home-manager:
home-manager.users.[你的用户名] = { pkgs, ... }: { programs = { zsh = { initExtra = '' source ${pkgs.zsh-vi-mode}/share/zsh-vi-mode/zsh-vi-mode.plugin.zsh ''; }; }; };
你也可以使用 home-manager 内置的"插件"功能:
home-manager.users.[你的用户名] = { pkgs, ... }: { programs = { zsh = { plugins = [ { name = "vi-mode"; src = pkgs.zsh-vi-mode; file = "share/zsh-vi-mode/zsh-vi-mode.plugin.zsh"; } ]; }; }; };
Fig 为你现有的终端添加应用、快捷方式和自动完成功能。
只需一次点击即可安装 zsh-vi-mode。
<a href="https://fig.io/plugins/other/zsh-vi-mode" target="_blank"><img src="https://yellow-cdn.veclightyear.com/835a84d5/31a8078c-fdfb-48b8-95dc-cbb321d70ba4.svg" /></a>
可在 dm9pZCAq overlay 中获取
eselect repository enable dm9pZCAq emerge --sync dm9pZCAq emerge app-shells/zsh-vi-mode
然后在 .zshrc(或 .bashrc)中引用
source /usr/share/zsh/site-contrib/zsh-vi-mode/zsh-vi-mode.plugin.zsh
将此仓库克隆到某个位置(例如 $HOME/.zsh-vi-mode)
git clone https://github.com/jeffreytse/zsh-vi-mode.git $HOME/.zsh-vi-mode
然后在 .zshrc(或 .bashrc)中引用
source $HOME/.zsh-vi-mode/zsh-vi-mode.plugin.zsh
使用 ESC 或 CTRL-[ 进入 普通模式。
但有些人可能喜欢自定义的 escape 键,比如 jj、jk 等,如果你想自定义 escape 键,可以从这里了解更多。
ctrl-p : 历史记录中的上一个命令ctrl-n : 历史记录中的下一个命令/ : 在历史记录中向后搜索n : 重复上一次 / 搜索默认情况下,普通模式 用方块样式光标表示,插入模式 用条形样式光标表示。
在 普通模式 下,你可以使用 vv 在编辑器(如 vi/vim/nvim...)中编辑当前命令行,因为它被绑定到了 可视模式。
你可以通过 ZVM_VI_EDITOR 选项更改编辑器,默认为 $EDITOR。
$ : 移动到行尾^ : 移动到行首第一个非空白字符0 : 移动到行首w : 向前移动 [count] 个单词W : 向前移动 [count] 个大单词e : 向前移动到单词末尾 [count] 次(包含)E : 向前移动到大单词末尾 [count] 次(包含)b : 向后移动 [count] 个单词B : 向后移动 [count] 个大单词t{char} : 向右查找第 [count] 个 {char} 出现之前T{char} : 向左查找第 [count] 个 {char} 出现之前f{char} : 向右查找第 [count] 个 {char} 出现F{char} : 向左查找第 [count] 个 {char} 出现; : 重复上一次 f、t、F 或 T 操作 [count] 次, : 反向重复上一次 f、t、F 或 T 操作i : 在光标前插入文本I : 在行首插入文本a : 在光标后追加文本A : 在行尾追加文本o : 在当前行下方插入新的命令行O : 在当前行上方插入新的命令行有两种环绕操作的按键绑定模式,默认为 经典 模式,你可以通过设置 ZVM_VI_SURROUND_BINDKEY 选项来选择模式。
经典 模式(动作->s->环绕)S" : 为可视选择添加 "ys" : 为可视选择添加 "cs"' : 将 " 更改为 'ds" : 删除 "s-前缀 模式(s->动作->环绕)sa" : 为可视选择添加 "sd" : 删除 "sr"' : 将 " 更改为 '注意,按键序列必须相当快速地按下,以避免超时。你可以通过 ZVM_KEYTIMEOUT 选项 延长这个超时时间。
vi" : 选择引号内的文本对象va( : 选择括号内的文本对象(包括括号)然后你可以对选择进行任何操作:
vi" -> S[ 或 sa[ => "object" -> "[object]"va" -> S[ 或 sa[ => "object" -> ["object"]di( 或 vi( -> dca( 或 va( -> cyi( 或 vi( -> y在普通模式下,输入 ctrl-a 将增加到下一个关键词,输入 ctrl-x 将减少到下一个关键词。关键词可以在光标处,也可以在光标右侧(同一行)。关键词可以是以下类型:
例如:
9 => 10aa99bb => aa100bbaa100bc => aa101bc0xDe => 0xdf0Xdf => 0Xe00b101 => 0b1100B11 => 0B101true => falseyes => noon => offT => FFri => SatOct => NovMonday => TuesdayJanuary => February+ => -++ => --== => !=!== => ===&& => ||and => or100 => 99aa100bb => aa99bb0 => -10xdE0 => 0xDDF0xffFf0 => 0xfffef0xfffF0 => 0xFFFEF0x0 => 0xffffffffffffffff0Xf => 0Xe0b100 => 0b0100B100 => 0B011True => FalseOn => OffSun => SatJan => DecMonday => SundayAugust => July/ => *++ => --== => !=!== => ===|| => &&or => and你可以使用以下选项来自定义退出键,以更好地符合你的偏好,比如 jj 或 jk 等。
ZVM_VI_ESCAPE_BINDKEY: 所有模式下的 vi 退出键(默认为 ^[ => ESC)ZVM_VI_INSERT_ESCAPE_BINDKEY: 插入模式下的 vi 退出键(默认为 $ZVM_VI_ESCAPE_BINDKEY)ZVM_VI_VISUAL_ESCAPE_BINDKEY: 可视模式下的 vi 退出键(默认为 $ZVM_VI_ESCAPE_BINDKEY)ZVM_VI_OPPEND_ESCAPE_BINDKEY: 操作符待定模式下的 vi 退出键(默认为 $ZVM_VI_ESCAPE_BINDKEY)例如:
# 仅在插入模式下将退出键更改为 `jk`,我们仍然在其他模式下使用默认的 `^[` 键绑定 ZVM_VI_INSERT_ESCAPE_BINDKEY=jk
该插件支持选择读键引擎来读取和处理按键事件。可以通过 ZVM_READKEY_ENGINE 选项轻松实现,目前支持以下引擎:
ZVM_READKEY_ENGINE_NEX: 这是一个更好的读键引擎,用于替代 ZLE(测试版)。ZVM_READKEY_ENGINE_ZLE: 这是 Zsh 的默认读键引擎(ZLE)。ZVM_READKEY_ENGINE_DEFAULT: 这是该插件的默认引擎(目前是 NEX 引擎)。NEX 是一个比 Zsh 的 ZLE 引擎更好的读取和处理按键事件的引擎,目前 NEX 引擎仍处于测试阶段,如果你愿意,可以切换回 Zsh 的 ZLE 引擎。
例如:
# 切换到 Zsh 的默认读键引擎 ZVM_READKEY_ENGINE=$ZVM_READKEY_ENGINE_ZLE
你可以使用 ZVM_KEYTIMEOUT 选项来调整等待下一个按键的输入超时时间,默认为 0.4 秒。
退出键是一个特殊情况,它可以单独使用。NEX 引擎在接收到退出字符后会等待一段时间,以确定它是单独使用还是转义序列的一部分。在等待期间,额外的按键会使退出键表现为元键。如果没有其他按键输入,它将被视为单独的退出键。
对于 NEX 引擎,我们可以使用 ZVM_ESCAPE_KEYTIMEOUT 选项来调整退出键的等待超时时间,默认为 0.03 秒。
由于有些配置选项依赖于插件中定义的一些变量,而有些则不依赖。我们需要提供一个统一的配置入口函数。入口函数的名称存储在一个名为 ZVM_CONFIG_FUNC 的选项中,默认值为 zvm_config,你可以根据自己的喜好更改为其他名称。
如果这个配置函数存在,它将被自动调用,你可以在加载这个插件之前在这个方面进行一些配置。例如:
function zvm_config() { ZVM_LINE_INIT_MODE=$ZVM_MODE_INSERT ZVM_VI_INSERT_ESCAPE_BINDKEY=jk } source ~/zsh-vi-mode.zsh
该插件提供了一种执行额 外命令的机制,现在你可以在以下方面执行一些操作:
zvm_before_init_commands=() zvm_after_init_commands=() zvm_before_select_vi_mode_commands=() zvm_after_select_vi_mode_commands=() zvm_before_lazy_keybindings_commands=() zvm_after_lazy_keybindings_commands=()
由于默认的初始化模式,该插件会覆盖之前的键绑定,这会导致其他插件(如 fzf、zsh-autocomplete 等)的键绑定失效。
你可以按以下方式解决兼容性问题:
# 直接追加一个命令 zvm_after_init_commands+=('[ -f ~/.fzf.zsh ] && source ~/.fzf.zsh')
或者
# 定义一个初始化函数并追加到 zvm_after_init_commands function my_init() { [ -f ~/.fzf.zsh ] && source ~/.fzf.zsh } zvm_after_init_commands+=(my_init)
或者
# 插件会自动执行这个 zvm_after_init 函数 function zvm_after_init() { [ -f ~/.fzf.zsh ] && source ~/.fzf.zsh }
或者如果你使用的是 zinit:
# 推迟加载 `fzf` zinit ice lucid wait zinit snippet OMZP::fzf
默认情况下,延迟键绑定功能是启用的,所有 normal 和 visual 模式的键绑定应该通过 zvm_after_lazy_keybindings_commands 执行。例如:
# 插件会自动执行这个 zvm_after_lazy_keybindings 函数 function zvm_after_lazy_keybindings() { bindkey -M vicmd 's' your_normal_widget bindkey -M visual 'n' your_visual_widget }
该插件提供了两个函数,用于定义自定义小部件和键绑定。为了避免不必要的问题,最好使用它们,特别是当你遇到按键冲突时。
要定义一个自定义小部件,你应该:
# 如果 [your_custom_widget] 被忽略,它将与 <your_custom_widget> 相同 zvm_define_widget <your_custom_widget> [your_custom_function]
要定义一个键绑定,你应该:
zvm_bindkey <keymap> <keys> <widget>
例如:
# 你的自定义小部件 function my_custom_widget() { echo 'Hello, ZSH!' } # 插件会自动执行这个 zvm_after_lazy_keybindings 函数 function zvm_after_lazy_keybindings() { # 在这里我们定义自定义小部件 zvm_define_widget my_custom_widget # 在普通模式下,按 Ctrl-E 调用这个小部件 zvm_bindkey vicmd '^E' my_custom_widget }
该插件提供了一个 ZVM_MODE 变量,用于获取当前的 vi 模式并更好地显示指示器。
目前支持以下模式:
ZVM_MODE_NORMAL ZVM_MODE_INSERT ZVM_MODE_VISUAL ZVM_MODE_VISUAL_LINE ZVM_MODE_REPLACE
要更新 vi 模式指示器,我们应该将命令添加到 zvm_after_select_vi_mode_commands 中。例如:
# 插件将自动执行此 zvm_after_select_vi_mode 函数 function zvm_after_select_vi_mode() { case $ZVM_MODE in $ZVM_MODE_NORMAL) # 你想做的事情... ;; $ZVM_MODE_INSERT) # 你想做的事情... ;; $ZVM_MODE_VISUAL) # 你想做的事情... ;; $ZVM_MODE_VISUAL_LINE) # 你 想做的事情... ;; $ZVM_MODE_REPLACE) # 你想做的事情... ;; esac }
该插件为用户提供了一些选项,以自定义光标样式,以获得更好的终端兼容性。
ZVM_CURSOR_STYLE_ENABLED 选项禁用此功能(默认为 true)# 禁用光标样式功能 ZVM_CURSOR_STYLE_ENABLED=false
# 普通模式下的提示符光标 ZVM_NORMAL_MODE_CURSOR # 插入模式下的提示符光标 ZVM_INSERT_MODE_CURSOR # 可视模式下的提示符光标 ZVM_VISUAL_MODE_CURSOR # 可视行模式下的提示符光标 ZVM_VISUAL_LINE_MODE_CURSOR # 操作符待定模式下的提示符光标 ZVM_OPPEND_MODE_CURSOR
ZVM_CURSOR_USER_DEFAULT ZVM_CURSOR_BLOCK ZVM_CURSOR_UNDERLINE ZVM_CURSOR_BEAM ZVM_CURSOR_BLINKING_BLOCK ZVM_CURSOR_BLINKING_UNDERLINE ZVM_CURSOR_BLINKING_BEAM
ZVM_INSERT_MODE_CURSOR=$ZVM_CURSOR_BEAM ZVM_NORMAL_MODE_CURSOR=$ZVM_CURSOR_BLOCK ZVM_OPPEND_MODE_CURSOR=$ZVM_CURSOR_UNDERLINE
# 插件将自动执行此 zvm_config 函数 zvm_config() { # 获取默认光标样式 local ncur=$(zvm_cursor_style $ZVM_NORMAL_MODE_CURSOR) local icur=$(zvm_cursor_style $ZVM_INSERT_MODE_CURSOR) # 为光标添加自定义颜色 ZVM_INSERT_MODE_CURSOR=$icur'\e\e]12;red\a' ZVM_NORMAL_MODE_CURSOR=$ncur'\e\e]12;#008800\a' }
我们可以使用 ZVM_TERM 选项为插件设置终端类型以处理终端转义序列,默认为 $TERM。它可以是 xterm-256color、alacritty-256color、st-256color 等。对于某些终端模拟器来说,这对于正确显示光标很重要。
你可以使用 ZVM_VI_HIGHLIGHT_BACKGROUND、ZVM_VI_HIGHLIGHT_FOREGROUND 和 ZVM_VI_HIGHLIGHT_EXTRASTYLE 来更改高亮行为(包括环绕、可视行等),颜色值可以是颜色名称或十六进制颜色值。
例如:
ZVM_VI_HIGHLIGHT_FOREGROUND=green # 颜色名称 ZVM_VI_HIGHLIGHT_FOREGROUND=#008800 # 十六进制值 ZVM_VI_HIGHLIGHT_BACKGROUND=red # 颜色名称 ZVM_VI_HIGHLIGHT_BACKGROUND=#ff0000 # 十六进制值 ZVM_VI_HIGHLIGHT_EXTRASTYLE=bold,underline # 粗体和下划线
你可以通过 ZVM_LINE_INIT_MODE 选项设置命令行初始模式。
目前支持以下模式:
ZVM_MODE_LAST : 从上一次的模式开始(默认)。ZVM_MODE_INSERT : 从插入模式开始。ZVM_MODE_NORMAL : 从普通模式开始。例如:
# 每个命令行总是从插入模式开始 ZVM_LINE_INIT_MODE=$ZVM_MODE_INSERT
该插件支持延迟键绑定功能,默认启用。要禁用它,你可以在加载此插件之前将 ZVM_LAZY_KEYBINDINGS 选项设置为 false。此功能将推迟所有 normal 和 visual 模式的键绑定,直到你第一次进入普通模式。
这可以大大提高启动速度,特别是当你打开终端只想执行一个简单的命令时。
为了防止由插件加载顺序引起的各种与键绑定相关的问题,同时保持插件的功能不变,插件的初始化被推迟到第一个命令行开始时。
然而,几乎所有插件都在脚本被加载时初始化。因此,该插件提供了一个 ZVM_INIT_MODE 选项来更改初始化模式。
例如:
# 在脚本被加载时进行初始化(即立即初始化) ZVM_INIT_MODE=sourcing
非常感谢问题报告和拉取请求。如果你从未为开源项目做出过贡献,我很乐意指导你如何创建拉取请求。
你可以从开启一个问题开始,描述你想要解决的问题,我们将从那里开始。
本主题基于 MIT 许可证 © Jeffrey Tse。


多风格AI绘画神器
堆友平台由阿里巴巴设计团队创建,作为一款AI驱动的设计工具,专为设计师提供一站式增长服务。功能覆盖海量3D素材、AI绘画、实时渲染以及专业抠图,显著提升设计品质和效率。平台不仅提供工具,还是一个促进创意交流和个人发展的空间,界面友好,适合所有级别的设计师和创意工作者。


零代码AI应用开发平台
零代码AI应用开发平台,用户只需一句话简单描述需求,AI能自动生成小程序、APP或H5网页应用,无需编写代码。


免费创建高清无水印Sora视频
Vora是一个免费创建高清无水印Sora视频的AI工具


最适合小白的AI自动化工作流平台
无需编码,轻松生成可复用、可变现的AI自动化工作流

大模型驱动的Excel数据处理工具
基于大模型交互的表格处理系统,允许用户通过对话方式完成数据整理和可视化分析。系统采用机器学习算法解析用户指令,自动执行排序、公式计算和数据透视等操作,支持多种文件格式导入导出。数据处理响应速度保持在0.8秒以内,支持超过100万行数据的即时分析。


AI辅助编程,代码自动修复
Trae是一种自适应的集成开发环境(IDE),通过自动化和多元协作改变开发流程。利用Trae,团队能够更快速、精确地编写和部署代码,从而提高编程效率和项目交付速度。Trae具备上下文感知和代码自动完成功能,是提升开发效率的理想工具。


AI论文写作指导平台
AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。


AI一键生成PPT,就用博思AIPPT!
博思AIPPT,新一代的AI生成PPT平台,支持智能生成PPT、AI美化PPT、文本&链接生成PPT、导入Word/PDF/Markdown文档生成PPT等,内置海量精美PPT模板,涵盖商务、教育、科技等不同风格,同时针对每个页面提供多种版式,一键自适应切换,完美适配各种办公场景。


AI赋能电商视觉革命,一站式智能商拍平台
潮际好麦深耕服装行业,是国内AI试衣效果最好的软件。使用先进AIGC能力为电商卖家批量提供优质的、低成本的商拍图。合作品牌有Shein、Lazada、安踏、百丽等65个国内外头部品牌,以及国内10 万+淘宝、天猫、京东等主流平台的品牌商家,为卖家节省将近85%的出图成本,提升约3倍出图效率,让品牌能够快速上架。


企业专属的AI法律顾问
iTerms是法大大集团旗下法律子品牌,基于最先进的大语言模型(LLM)、专业的法律知识库和强大的智能体架构,帮助企业扫清合规障碍,筑牢风控防线,成为您企业专属的AI法律顾问。
最新AI工具、AI资讯
独家AI资源、AI项目落地

微信扫一扫关注公众号