multiple-cursors.el

Emacs的多光标功能。这是一个相当疯狂的功能，所以是的，确实存在一些问题。不过不用担心，我自2011年以来一直在使用它，取得了巨大的成功并带来了很多乐趣。

维护警告

我每天都在使用这个包，而且已经用了很多年。它运行得很好。至少，对于我所有的使用场景都没有问题。如果出现任何问题，我会修复它。

然而，我清楚地意识到我没有时间去解决我自己没有遇到的问题。多年来，我一直无法跟上所有的问题和拉取请求。每当我尝试修复时，总会收到反馈说我的修复不够好，或者不符合某些我并不特别在意的标准。

因此，我关闭了问题追踪器和拉取请求。我希望你能像我一样愉快地使用这个包。如果它对你不起作用，那我感到抱歉。幸运的是，Emacs是无限可塑的，你可能可以自己修复它。

总之：我仍在维护这个包，但我不再通过众包方式收集问题列表。

安装

我强烈建议通过package.el安装multiple-cursors。

它可在MELPA、MELPA Stable和NonGNU ELPA（从Emacs 28开始默认启用）上获得：

M-x package-install multiple-cursors

该包依赖于cl-lib包，所以如果你不使用package.el或者没有最新版本的Emacs，你还需要安装它：参见GNU ELPA。

基本用法

首先：

(require 'multiple-cursors)

然后你需要设置快捷键绑定 - multiple-cursors并不会假定你希望如何布局它们。以下是一些示例：

当你有一个跨越多行的活动区域时，以下命令将为每行添加一个光标：

(global-set-key (kbd "C-S-c C-S-c") 'mc/edit-lines)

当你想要添加多个光标，但不是基于连续的行，而是基于缓冲区中的关键词时，使用：

(global-set-key (kbd "C->") 'mc/mark-next-like-this)
(global-set-key (kbd "C-<") 'mc/mark-previous-like-this)
(global-set-key (kbd "C-c C-<") 'mc/mark-all-like-this)

首先标记单词，然后添加更多光标。

要退出多光标模式，按<return>或C-g。后者会先禁用多个区域，然后再禁用多光标。如果你想在多光标模式下插入换行符，使用C-j。

视频

你可以在Emacs Rocks观看multiple-cursors的介绍视频。

命令概览

标记更多出现

• mc/mark-next-like-this：在缓冲区前方匹配当前区域的下一个位置添加光标和区域。
• mc/mark-next-like-this-word：在缓冲区前方匹配当前区域的下一个位置添加光标和区域，如果没有选中区域，则选中光标处的单词。
• mc/mark-next-like-this-symbol：在缓冲区前方匹配当前区域的下一个位置添加光标和区域，如果没有选中区域，则选中光标处的符号。
• mc/mark-next-word-like-this：类似mc/mark-next-like-this，但仅适用于整个单词。
• mc/mark-next-symbol-like-this：类似mc/mark-next-like-this，但仅适用于整个符号。
• mc/mark-previous-like-this：在缓冲区后方匹配当前区域的下一个位置添加光标和区域。
• mc/mark-previous-like-this-word：在缓冲区后方匹配当前区域的下一个位置添加光标和区域，如果没有选中区域，则选中光标处的单词。
• mc/mark-previous-like-this-symbol：在缓冲区后方匹配当前区域的下一个位置添加光标和区域，如果没有选中区域，则选中光标处的符号。
• mc/mark-previous-word-like-this：类似mc/mark-previous-like-this，但仅适用于整个单词。
• mc/mark-previous-symbol-like-this：类似mc/mark-previous-like-this，但仅适用于整个符号。
• mc/mark-more-like-this-extended：使用箭头键快速标记/跳过下一个/上一个出现。
• mc/add-cursor-on-click：绑定到鼠标事件以通过点击添加光标。参见技巧部分。
• mc/mark-pop：在当前点设置一个光标，并移动到标记栈上的下一个（不同的）位置。这允许对光标的放置进行精细控制。

调整当前光标

• mc/unmark-next-like-this：移除缓冲区中最下方的光标。
• mc/unmark-previous-like-this：移除缓冲区中最上方的光标。
• mc/skip-to-next-like-this：移除最下方的光标，标记下一个出现。
• mc/skip-to-previous-like-this：移除最上方的光标，标记上一个出现。

标记多个出现

• mc/edit-lines：在当前区域的每一行添加一个光标。
• mc/edit-beginnings-of-lines：在当前区域的每行开头添加一个光标。
• mc/edit-ends-of-lines：在当前区域的每行末尾添加一个光标。
• mc/mark-all-like-this：标记缓冲区中所有匹配当前区域的部分。
• mc/mark-all-words-like-this：类似mc/mark-all-like-this，但仅适用于整个单词。
• mc/mark-all-symbols-like-this：类似mc/mark-all-like-this，但仅适用于整个符号。
• mc/mark-all-in-region：提示输入一个字符串，在区域内匹配所有出现并添加光标。
• mc/mark-all-like-this-in-defun：标记当前函数定义中所有匹配当前区域的部分。
• mc/mark-all-words-like-this-in-defun：类似mc/mark-all-like-this-in-defun，但仅适用于整个单词。
• mc/mark-all-symbols-like-this-in-defun：类似mc/mark-all-like-this-in-defun，但仅适用于整个符号。
• mc/mark-all-dwim：尝试智能地标记你想要的所有内容。可以多次按下。

特殊功能

• set-rectangular-region-anchor：将此功能视为set-mark，但你正在标记一个矩形区域。
• mc/mark-sgml-tag-pair：标记当前的开放和闭合标签。
• mc/insert-numbers：为每个光标插入递增的数字，从上到下。
• mc/insert-letters：为每个光标插入递增的字母，从上到下。
• mc/sort-regions：按字母顺序对标记的区域进行排序。
• mc/reverse-regions：反转标记区域的顺序。
• mc/vertical-align：用给定的字符将所有光标垂直对齐到列号最高（最右）的光标。（如果同一行上有多个光标，可能无法按预期工作。）
• mc/vertical-align-with-space：像mc/vertical-align一样用空格对齐所有光标。

技巧和窍门

• 要退出多光标模式，按<return>或C-g。后者会先禁用多个区域，然后再禁用多光标。如果你想在多光标模式下插入换行符，使用C-j。

• (define-key mc/keymap (kbd "<return>") nil)将使<return>插入换行符；多光标模式仍然可以用C-g禁用。

• 有时你可能会发现光标超出了视图范围。你可以用C-v和M-v滚动屏幕使每个光标居中，或者按C-'隐藏所有没有光标的行，再次按C-'取消隐藏。

• 尝试在没有选中区域的情况下按mc/mark-next-like-this。它会在下一行添加一个光标。

• 尝试在没有选中区域的情况下按mc/mark-next-like-this-word或mc/mark-next-like-this-symbol。它会标记单词或符号并在下一个出现处添加一个光标。

• 尝试在html-mode中对标签名使用mc/mark-all-like-this-dwim。

• 注意模式行中可以看到当前活动的光标数量。

• 如果你退出多光标模式并粘贴 - 它只会从主光标的剪贴环中粘贴。要从每个光标的剪贴环中粘贴，使用矩形粘贴，通常绑定在C-x r y。

• 你可以在没有选中任何内容且只有一个光标的情况下使用mc/reverse-regions。它会翻转光标处的S表达式和它下面的一个。

• 当你使用mc/edit-lines时,你可以给它一个正数或负数前缀来改变它在行太短时的行为。

• 如果你想保持全局绑定简洁,并在区域激活时获得自定义键绑定,你可以尝试region-bindings-mode。

• 有一个特殊的钩子会在模式被禁用时运行(相当于光标数量回到1): multiple-cursors-mode-disabled-hook

顺便说一句,我强烈建议将mc/mark-next-like-this绑定到靠近er/expand-region键的键绑定上。

绑定鼠标事件

要覆盖鼠标事件,你可能还需要解绑down-mouse部分的事件。像这样:

(global-unset-key (kbd "M-<down-mouse-1>"))
(global-set-key (kbd "M-<mouse-1>") 'mc/add-cursor-on-click)

或者你可以像我一样找一个未使用但不太方便的绑定:

(global-set-key (kbd "C-S-<mouse-1>") 'mc/add-cursor-on-click)

未知命令

Multiple-cursors使用两个命令列表来知道该做什么:运行一次列表和全部运行列表。它带有一组默认值,但试图包含所有已知的Emacs命令是非常愚蠢的。

这就是为什么multiple-cursors偶尔会询问如何处理某个命令。它会通过将你的选择保存在~/.emacs.d/.mc-lists.el中来记住你的选择。你可以通过以下方式更改位置:

(setq mc/list-file "/my/preferred/file")

注意!确保在加载multiple-cursors之前这样做。

可以将multiple-cursors设置为对每个命令"全部运行",除了那些列在mc/cmds-to-run-once中的命令。要启用此功能,请将mc/always-run-for-all设置为非nil值。在".mc-lists.el"中将需要运行一次的命令添加到mc/cmds-to-run-once中。

已知限制

• isearch-forward和isearch-backward不支持多光标。 如果你想要这个功能,你可以使用phi-search。
• 所有引用lambda的键绑定总是为所有光标运行。如果你 需要限制它,你必须给它一个名字。
• 重做可能会扰乱你的光标。撤销工作得很好。

贡献

是的,请贡献。有一套测试,所以记得为你的 具体功能添加测试,否则我以后可能会破坏它。

你可以在这里找到仓库:

https://github.com/magnars/multiple-cursors.el

要获取测试依赖项,如果你还没有安装cask,请先安装, 然后:

$ cd /path/to/multiple-cursors
$ cask

运行测试:

$ ./run-tests.sh

贡献者

• Takafumi Arakaki贡献了几个小改进
• Marco Baringer为mc/cycle贡献了循环功能,并为mark-more添加了不带区域的光标
• Ivan Andrus添加了在模式行显示光标数量,以及mc/edit-lines处理短行的不同选项
• Fuco添加了mc/mark-all-like-this-dwim的第一个版本
• Zach Kost-Smith添加了mc/mark-pop
• Maciej Katafiasz添加了mc/mark-all-dwim
• Aleksey Fedotov添加了mc-hide-unmatched-lines-mode
• Jules Tamagnan添加了mc/mark-next-like-this-word和mc/mark-next-like-this-symbol
• Ingo Lohmar扩展了mc/add-cursor-on-click以切换光标
• Andrea Orru添加了mc/mark-previous-like-this-word/-symbol

谢谢!

许可证

版权所有 (C) 2012-2016 Magnar Sveen

作者: Magnar Sveen magnars@gmail.com 关键词: 编辑 光标

本程序是自由软件;你可以根据自由软件基金会发布的GNU通用公共许可证的条款重新分发和/或修改它, 可以选择使用许可证的第3版,或(由你选择)任何更高版本。

本程序的发布是希望它能有用, 但没有任何保证;甚至没有对适销性或特定用途适用性的暗示保证。详情请参阅 GNU通用公共许可证。

你应该已经收到了一份GNU通用公共许可证 和本程序一起。如果没有,请参阅http://www.gnu.org/licenses/。