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

编辑

一个满足简单需求的简易编辑器。

这个编辑器向经典的 MS-DOS 编辑器 致敬，但具有现代界面和类似 VS Code 的输入控制。其目标是提供一个即使对终端不太熟悉的用户也能轻松使用的可访问编辑器。

安装

你也可以从 我们的发布页面 下载二进制文件。

窗口

你可以使用 WinGet 安装最新版本：

winget install Microsoft.Edit

Linux（从源码构建）

如果你的发行版没有提供二进制文件，或者你想自己构建，可以使用我们的安装脚本，前提是你已经安装了：

• Rust（通过 rustup 或类似方式）
• A C compiler (e.g. gcc)
• ICU（例如 libicu78、libicu、icu）
• curl/wget 和 tar

然后，以下命令将把 msedit 安装到 ~/.local/bin 中：

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/microsoft/edit/main/assets/install.sh | sh

额外的标志是 --dev，用于直接从主分支构建，以及 --system，用于安装到 /usr/local/bin。例如：

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/microsoft/edit/main/assets/install.sh | sh -s -- --dev --system

macOS

你可以使用 Homebrew 安装最新版本：

brew install msedit

构建说明

• Install Rust
• 克隆仓库
• 如果你使用的是夜间版 Rust：

  cargo build --release --config .cargo/release.toml

• 如果你使用的是稳定版 Rust：
  • 理想情况下：设置环境变量 RUSTC_BOOTSTRAP=1 并使用上面的 nightly 构建说明。
    这是推荐的，因为它可以大幅减少二进制文件的大小，并略微提高性能。
  • 否则，只需运行：

    cargo build --release

构建配置

您可以在构建时设置以下环境变量来配置构建：

环境变量 | 描述 --- | --- EDIT_CFG_ICU* | 详细信息请参见下文的 ICU 库名称 (SONAME)。建议 Linux 软件包维护者查看并配置这些选项。 EDIT_CFG_LANGUAGES | 以逗号分隔的要包含在构建中的语言列表。可用语言请参见 i18n/edit.toml。

软件包维护者注意事项

软件包命名

标准可执行文件名称为“edit”，备选名称为“msedit”。我们意识到“edit”可能与现有命令冲突，并建议将软件包和可执行文件命名为“msedit”。应避免使用如“ms-edit”之类的名称。如有可能，建议设置“edit”别名。

ICU 库名称 (SONAME)

该项目可选依赖 ICU 库以实现其搜索和替换功能。

默认情况下，项目将查找以下库名称：

变量 | Windows | macOS | Linux / 其他 ----------|---------|-------|--------------- EDIT_CFG_ICUUC_SONAME | icuuc.dll | libicucore.dylib | libicuuc.so EDIT_CFG_ICUI18N_SONAME | icuin.dll | libicucore.dylib | libicui18n.so

如果您的安装使用不同的 SONAME，请在构建时设置以下环境变量：

• EDIT_CFG_ICUUC_SONAME: For instance, libicuuc.so.76.
• EDIT_CFG_ICUI18N_SONAME: For instance, libicui18n.so.76.

此外，该项目假设 ICU 导出的符号没有 _ 前缀且没有版本后缀，如 u_errorName。如果您的安装使用带版本的导出，请设置：

• EDIT_CFG_ICU_CPP_EXPORTS ：如果设置为 true，将查找类似 _u_errorName 的 C 符号。在 macOS 上默认启用。
• EDIT_CFG_ICU_RENAMING_VERSION ：如果设置为版本号，例如 76，将查找类似 u_errorName_76 的符号。

最后，您可以设置以下环境变量：

• EDIT_CFG_ICU_RENAMING_AUTO_DETECT ：如果设置为 true，可执行文件将在运行时尝试检测 EDIT_CFG_ICU_RENAMING_VERSION 的值。此方法未得到 ICU 官方支持，因此不建议依赖。在 UNIX (不包括 macOS) 上，如果未设置其他选项，则默认启用。

要测试您的构建设置，请以 --ignored 标志运行 cargo test。例如：

cargo test -- --ignored