micro

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

micro 是一个基于终端的文本编辑器，旨在易于使用和直观，同时也利用现代终端的功能。它作为一个独立的、内置所有功能的静态二进制文件提供，没有任何依赖；你可以立即下载并使用它！

顾名思义，micro 旨在成为 nano 编辑器的某种继任者，易于安装和使用。它努力成为那些喜欢在终端中工作的人的全职编辑器，或者那些经常通过 SSH 编辑文件的人的愉快选择。

这是 micro 编辑其源代码的图片。

要查看更多 micro 的截图，展示一些默认配色方案，请参见 这里。

你也可以访问 Micro 的官方网站 https://micro-editor.github.io

功能

• 易于使用和安装。
• 不需要依赖或外部文件——只需下载页面下方的二进制文件即可。
• 多光标。
• 常用快捷键 (Ctrl-s、Ctrl-c、Ctrl-v、Ctrl-z，…)。
  • 快捷键可以按你的喜好重新绑定。
• 合理的默认设置。
  • 开箱即用时无需做太多配置（并且配置非常简单）。
• 分割和标签页。
• 类似 nano 的菜单帮助你记住快捷键。
• 极佳的鼠标支持。
  • 这意味着可以用鼠标拖动创建选区，双击按单词选择，三击按行选择。
• 跨平台（应能在 Go 支持的所有平台上运行）。
  • 注意，虽然支持 Windows，但不支持 Mingw/Cygwin（见下文）。
• 插件系统（插件使用 Lua 编写）。
  • micro 内置插件管理器，可自动安装、移除和更新插件。
• 内置差异显示区。
• 简单的自动补全。
• 持久化撤销。
• 自动代码检查和错误通知。
• 支持超过130种语言的语法高亮。
• 配色方案支持。
  • 默认情况下，micro 提供 16 色、256 色和真彩色主题。
• 真彩色支持。
• 使用系统剪贴板进行复制和粘贴。
• 小巧且简单。
• 易于配置。
• 宏功能。
• 智能高亮显示尾随空格及制表符与空格错误。
• 常见编辑器功能，如撤销/重做、行号、Unicode 支持、软换行等。

安装

要安装 micro，你可以下载一个预编译的二进制文件，或者你可以从源码构建它。

如果你想了解更多关于安装 micro 的方式，请参阅此wiki 页面。

安装后使用 micro -version 获取版本信息。只有当你从预编译二进制文件、Homebrew 或 Snap 安装时，才能保证安装的是最新的稳定版本。

桌面入口文件和 man 手册页可以在 assets/packaging 目录中找到。

预编译二进制文件

预编译二进制文件在 releases 中发布。

要卸载 micro，只需删除二进制文件，以及位于 ~/.config/micro 的配置目录。

第三方快速安装脚本

curl https://getmic.ro | bash

该脚本将把微型二进制文件放置在当前目录中。从那里，您可以将其移动到您选择的路径目录（例如 sudo mv micro /usr/bin）。更多信息请参见其GitHub 仓库。

自己的

安装了Eget后，您可以轻松获取预构建的二进制文件：

eget micro-editor/micro

使用 --tag VERSION 下载特定标签版本。

eget --tag nightly micro-editor/micro # download the nightly version (compiled every day at midnight UTC)
eget --tag v2.0.8 micro-editor/micro  # download version 2.0.8 rather than the latest release

您可以通过将 --to /usr/local/bin 添加到 eget 命令中来安装 micro，或者在下载完成后将二进制文件手动移动到您 $PATH 上的某个目录中。

有关更多信息，请参见 Eget。

软件包管理器

您可以使用 Homebrew 在 Mac 上安装 micro:

brew install micro

Mac 注意事项: 所有 micro 快捷键使用 control 或 alt（option）键，而不是 command 键。默认情况下，macOS 终端不会转发 alt 键事件。要解决此问题，请参见下面的 macOS 终端 部分。

在 Linux 上，你可以通过 snap 安装 micro。

snap install micro --classic

Micro 也可以通过 Linux 上的其他包管理器获得，例如 dnf、AUR、Nix，以及其他操作系统的包管理器。这些包不保证是最新的。

• Linux：
  • 特定发行版的包管理器：
    • dnf install micro（Fedora）。
    • apt install micro（适用于 Ubuntu 和 Debian）。
    • pacman -S micro（Arch Linux）。
    • emerge app-editors/micro（Gentoo）。
    • zypper install micro-editor（SUSE）
    • eopkg install micro（Solus）。
    • pacstall -I micro (Pacstall)。
    • apt-get install micro（ALT Linux）
    • 有关 CRUX、Termux 的详细信息，请参见 wiki。
  • 与发行版无关的软件包管理器：
    • nix profile install nixpkgs#micro（在启用 Nix 和 flakes 的情况下）
    • flox install micro（使用 Flox）
• Windows：Chocolatey、Scoop 和 WinGet。
  • choco install micro。
  • scoop install micro。
  • winget install zyedidia.micro
• OpenBSD：可以在ports树中找到，也可以作为二进制软件包使用。
  • pkg_add -v micro。
• NetBSD、macOS、Linux、Illumos 等系统，通过 pkgsrc-current：
  • pkg_add micro
• macOS：可通过软件包管理器安装。
  • sudo port install micro（使用 MacPorts）
  • brew install micro（使用 Homebrew）
  • nix profile install nixpkgs#micro（在启用 Nix 和 flakes 的情况下）
  • flox install micro（使用 Flox）

Linux 桌面环境注意事项：

要与本地系统剪贴板进行交互，需要安装以下工具：

• 对于 X11，xclip 或 xsel
• 对于 Wayland，wl-clipboard

如果未安装这些工具，micro 将使用内部剪贴板进行复制和粘贴，但外部应用程序无法访问。

从源码构建

如果您的操作系统没有二进制版本，但可以运行 Go，您可以从源码构建。

确保您的 Go 版本为 1.19 或更高，并且已启用 Go 模块。

git clone https://github.com/micro-editor/micro
cd micro
make build
sudo mv micro /usr/local/bin # optional

二进制文件将被放置在当前目录中，可以移动到你喜欢的任何地方（例如 /usr/local/bin）。

命令 make install 将会把二进制文件安装到 $GOPATH/bin 或 $GOBIN。

你可以直接使用 go get（go get github.com/micro-editor/micro/cmd/micro）进行安装，但不推荐这样做，因为这样不会用版本信息构建 micro（插件管理器需要），并且不会禁用调试模式。

完全静态或动态链接的二进制文件

默认情况下，micro 二进制文件进行静态链接，以增加预构建二进制文件的可移植性。通过为构建目标提供 CGO_ENABLED=1，可以轻松覆盖此行为。

CGO_ENABLED=1 make build

之后，微型二进制文件将与当前的核心系统库动态链接。

Mac 注意事项： 本地 macOS 构建使用 CGO_ENABLED=1 强制设置，以支持在链接步骤中添加“信息属性列表”。

macOS 终端

如果您使用 macOS，应考虑使用 iTerm2 代替默认终端 (Terminal.app)。iTerm2 终端具有更好的鼠标支持以及更好的按键事件处理。为了获得最佳按键绑定效果，在 Preferences->Profiles->Keys->Presets... 下选择 xterm defaults，并在同一菜单中为 Left Option Key 选择 Esc+。最新版本还支持真彩色。

如果您仍坚持使用默认的 Mac 终端，请确保在 Preferences->Profiles->Keyboard 下将 Use Option key as Meta key 设置为使用 option 作为 alt。

WSL 和 Windows 控制台

如果您在 WSL 中使用 micro，强烈建议使用 Windows Terminal 代替默认的 Windows 控制台。

如果因某些原因必须使用 Windows 控制台，请注意 Windows 控制台 WSL 中有一个错误，当 micro 尝试通过 powershell 访问外部剪贴板时，会导致字体更改。要修复此问题，请使用内部剪贴板和 set clipboard internal（尽管您的系统剪贴板将不再在 micro 中可用）。

颜色和语法高亮

如果您打开 micro 后似乎语法高亮未启用，这可能是因为您使用的终端不支持 256 色模式。在 micro 中按 Ctrl-e 并输入 set colorscheme simple 尝试将配色方案更改为 simple。

如果您使用默认的 Ubuntu 终端，要启用 256 色模式，请确保您的 TERM 变量设置为 xterm-256color。

许多 Windows 终端不支持超过 16 种颜色，这意味着 micro 的默认配色方案看起来不会很好。您可以将配色方案设置为 simple，或者下载并配置比 Windows 默认终端更好的终端模拟器。

Cygwin、Mingw、Plan9

很遗憾，Cygwin、Mingw 和 Plan9 不受官方支持。在 Cygwin 和 Mingw 中，当使用 winpty 工具运行时，micro 通常可以正常工作：

winpty micro.exe ...

Micro 使用了惊人的 tcell 库，但这意味着 micro 受限于 tcell 支持的平台。因此，micro 不支持 Plan9 或 Cygwin（尽管未来可能会改变）。Micro 也不支持 NaCl（无论如何它已经被弃用）。

使用

一旦你构建了编辑器，通过运行 micro path/to/file.txt 或 micro 来启动它，以打开一个空缓冲区。

micro 还支持从 stdin 创建缓冲区：

ip a | micro

你可以使用箭头键和鼠标移动光标。

你也可以使用鼠标操作文本。只需点击并拖动即可选择文本。你还可以双击以启用单词选择，三击以启用行选择。

文档和帮助

micro 内置有帮助系统，你可以通过按下 Ctrl-e 并输入 help 来访问。此外，你可以在这里查看帮助文件：

• 主要帮助
• 快捷键绑定
• 命令
• 颜色
• 选项
• 插件

我还建议阅读 教程，以简要了解 micro 提供的更强大配置功能。

还有一个非官方的 Discord，你可以在 https://discord.gg/nhWR6armnR 加入

贡献

如果你发现任何错误，请报告它们！我也很乐意接受任何人的拉取请求。

你可以使用 GitHub 问题跟踪器 来报告错误、提问或建议新功能。

如果想在更轻松的环境下讨论编辑器，你可以加入 Gitter 聊天 或 Discord。你也可以使用 GitHub 上的 讨论 区域，适合论坛式的讨论或问答。

有时我可能不会立即回应，对此我表示歉意！如果出现这种情况，请提醒我。