Helix
面向终端的模态代码编辑器，提供多光标选择、Tree-sitter 语法处理和内置 LSP 客户端，适合键盘驱动的代码编辑。
Helix 的编辑模型
Helix 是运行在终端中的模态代码编辑器，设计受到 Kakoune 与 Neovim 等工具影响。它强调“先选择、后操作”，可同时处理多个选择，并集成 Tree-sitter 语法高亮与文本对象、LSP 客户端、诊断、跳转和格式化能力。
Windows 包中的 runtime 不能省略
预编译包不仅包含 hx，还包含 runtime 目录。该目录保存语言查询等运行时资源，只复制可执行文件会造成高亮或语言功能异常。hx --health 会显示实际搜索的运行时路径；默认位置不合适时，可用 HELIX_RUNTIME 明确指定。
LSP 能力需要外部组件
Helix 提供语言服务器客户端和默认配置，但语言服务器二进制通常不随编辑器分发。用户需要按所用语言分别安装并让命令可被系统找到。项目级 .helix 配置还可能改变语言服务器、格式化器和根目录判断，运行陌生项目配置前应先审查命令和权限。
维护记录
本页于 2026-08-06 根据 Helix 预编译包、runtime 搜索、hx --health、模态多选、Tree-sitter 与外部语言服务器说明复核。归档文件为 25.07.1 Windows x64 压缩包。
保存到自己的网盘
打开网盘后可直接获取，也可以先保存到自己的网盘，方便换设备继续使用。
夸克网盘（无需提取码）
推荐将「Helix」保存到该网盘
百度网盘
将「Helix」保存到该网盘
Helix Windows 安装与首次编辑教程
Windows 预编译包不能只保留 hx.exe，runtime 目录同样重要。先验证编辑器和运行时健康状态，再为实际语言安装独立的语言服务器。
安装前准备
- 准备支持现代终端显示的 Windows 环境，并了解如何在 PowerShell 中查看和修改用户 PATH。
- 选择一个可丢弃的示例项目练习模态操作，不要直接在唯一源码副本上学习快捷键。
- 如果需要补全、诊断和跳转，先确认目标语言对应的语言服务器及其安装方式。
安装步骤
- 01
完整解压发布包
把 hx 可执行程序和 runtime 目录一起解压到固定位置，不要只移动 hx.exe 后删除其余内容。
- 02
配置命令与运行时
将 hx 所在目录加入用户 PATH；如果 runtime 不在默认搜索位置，使用 HELIX_RUNTIME 指向正确目录。
- 03
运行健康检查
执行 hx --health，确认运行时目录可读，再查看计划使用语言的语法、查询和语言服务器状态。
快速上手
- 01
打开测试项目
从项目根目录启动 hx 并打开示例文件，先练习普通模式、插入模式、移动、选择、撤销、保存和退出。
- 02
练习选择优先编辑
先选中单词、行或多个匹配项，再执行修改或删除；观察多选操作是否只影响预期范围。
- 03
启用语言能力
单独安装目标语言服务器并确保命令位于 PATH，重新运行 hx --health 后再测试诊断、跳转和补全。
使用建议
- 把个人 config.toml 与 languages.toml 纳入备份，但在升级后先用最小配置排除兼容问题。
- 项目级 .helix 配置会覆盖或合并用户和内置语言设置，接手陌生仓库时应先审查其中的命令。
- 自动格式化可能重写整个文件，首次启用前应在版本控制中查看差异。
故障排查与卸载方法
hx --health 提示 runtime 不完整怎么办？
确认下载包中的 runtime 未被移动或漏传，检查 Helix 搜索到的路径；必要时设置 HELIX_RUNTIME 后重开终端。
有语法高亮但没有补全和诊断怎么办？
Tree-sitter 高亮与 LSP 是两套能力。检查对应语言服务器是否已安装、命令是否在 PATH，以及 languages.toml 中的名称和项目根目录识别是否正确。
- 移除程序、运行时和配置从 PATH 和 HELIX_RUNTIME 中删除相关项，再移除 hx、runtime 及不再需要的用户配置；语言服务器需按各自方式单独卸载。
常见问题
Helix 解压后为什么不能正确高亮或加载查询？
预编译包同时包含 hx 和 runtime 目录。只复制可执行文件会缺少运行时查询；应让 runtime 位于 Helix 可搜索的位置，并通过 hx --health 检查实际路径。
Helix 是否自带所有语言服务器？
不自带。Helix 内置 LSP 客户端和语言配置，但各语言服务器通常需要另外安装并加入 PATH。可以用 hx --health 查看语言支持与缺失项目。
Helix 和普通文本编辑器的操作方式有什么区别？
Helix 采用模态、选择优先的编辑方式，先选择对象再执行动作。熟悉鼠标或插入模式编辑的用户需要先练习移动、选择、修改、撤销和保存退出。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。