10分钟快速上手ad编辑器从源码编译安装到打开第一个文件【免费下载链接】adan adaptable text editor项目地址: https://gitcode.com/gh_mirrors/ad5/ad想体验一款融合了 vim 模态编辑与 Plan 9 acme 编辑器理念的全新终端文本编辑器吗本文为你带来ad编辑器的快速上手教程从源码编译安装开始一步步带你完成环境准备、安装配置最终成功打开你的第一个文件。ad发音 A.D.是一个用 Rust 编写的可适应文本编辑器an adaptable text editor它以文本为核心让你既能编辑文本也能直接执行文本整个上手过程只需 10 分钟ad编辑器是什么为什么值得一试ad 是一款运行在终端里的现代文本编辑器设计灵感来自三个方向vim / kakoune 的模态编辑NORMAL、INSERT、COMMAND 等模式切换编辑效率极高Plan 9 acme / sam 的文本哲学文本不只是内容还可以被加载Load和执行ExecuteEmacs 的 minibuffer 概念基于迷你缓冲区的自定义模式简单说ad 的核心理念是做一个整合型开发环境integratING而不是被整合的开发环境integratED它不把功能都塞进编辑器而是让你现有的命令行工具直接与编辑器状态交互。此外ad 内置了自研的正则引擎src/regex/、基于 tree-sitter 的语法高亮src/syntax/、以及 LSP 客户端src/lsp/麻雀虽小五脏俱全。第一步准备 Rust 编译环境由于 ad 通过源码编译安装你需要先准备好 Rust 工具链。打开终端执行curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh安装完成后重新加载 shell 环境变量并验证版本source $HOME/.cargo/env cargo --version看到类似cargo 1.7x.x的输出说明 Rust 环境就绪。另外建议安装fd用于文件查找等常用命令行工具ad 默认用它来执行查找文件命令。第二步10分钟源码编译安装三步走获取 ad 源码并完成编译安装只需三个命令git clone https://gitcode.com/gh_mirrors/ad5/ad cd ad cargo install --path .cargo install --path .会编译整个工作区并将ad可执行文件安装到~/.cargo/bin由于项目包含多个 crate如 ninep、ad_event 等首次编译可能需要几分钟耐心等待即可。编译完成后验证安装是否成功ad --version第三步初始化配置文件ad 默认不会自带配置文件需要运行项目自带的初始化任务把默认配置、配色方案、plumbing 规则和辅助脚本复制到~/.ad目录cargo xtask setup-dotfiles这一步会创建~/.ad目录并复制以下内容config.toml主配置文件plumbing.rules文本路由规则colorschemes/默认明暗两套配色syntax/语法高亮定义lib/、bin/辅助脚本与函数库如果你想了解这个任务具体做了什么可以查看源码xtask/src/setup.rs。确认无误后再运行它这是最稳妥的最快配置方法。第四步打开你的第一个文件一切就绪现在打开 ad 并读取一个文件ad不带参数启动会显示欢迎界面。直接打开文件也很简单ad README.md你也可以一次性打开多个文件用空格分隔即可。启动后你会看到经典的模态编辑器界面底部左侧显示当前模式默认 NORMAL左侧有行号支持语法高亮。想查看内置帮助在 NORMAL 模式下输入:help回车即可打开完整的帮助文档这是新手了解 ad 的最佳入口。第五步掌握 ad 的基本操作ad 有五种编辑模式和 vim 一样通过按键切换模式作用进入方式NORMAL选择与操作文本默认模式按Esc返回INSERT增删文本按i或aCOMMAND执行内置命令按:RUN执行外部命令按!EDIT应用结构化正则按x或X与 vim 的动词-名词不同ad 在 NORMAL 模式采用 kakoune 风格的名词-动词操作先选中文本再执行操作。键位定义在src/mode/normal.rs中方便你对照学习。几个立刻能用的操作保存文件NORMAL 模式下输入:w回车退出编辑器输入:q回车加载文本把光标放在文件路径上按回车即可打开该文件执行文本把光标放在命令上按ad 会运行它并把输出放到$dir/output缓冲区最后这种文本即命令的玩法正是 ad 最有魅力的地方——它复刻了 acme 编辑器的核心交互。第六步个性化配置你的 ad编辑器ad 的配置文件位于~/.ad/config.toml主配置见仓库中的data/config.toml采用 TOML 格式。你可以在这里调整编辑器行为是否展开 Tab、Tab 宽度、状态栏消息停留时间等配色方案通过[colorscheme]配置前景色、背景色、语法高亮颜色也可直接切换colorschemes/中的明暗主题快捷键绑定[keys.normal]中可把按键映射到外部程序例如space w / { run new-column }用于分栏文件类型与 LSP[filetypes.rust]等段落可为每种语言配置扩展名识别和语言服务器修改保存后重启 ad 即可生效也可以使用-c参数指定自定义配置文件ad -c ~/my-ad-config.toml进阶玩法ad 的隐藏实力上手之后你还可以探索这些高级特性结构正则表达式ad 内置了 sam 编辑语言风格的编辑命令src/exec/支持对选区执行结构化正则替换9p 文件系统接口ad 通过自研的 ninep cratecrates/ninep/把编辑器状态暴露为虚拟文件系统src/fsys/外部程序可以直接读写编辑器内部数据——这是 acme 风格扩展的精髓命令行脚本模式无需打开图形界面直接对文件执行编辑脚本ad -e x/foo/ s/foo/bar/g myfile.txt常见问题与建议找不到fd命令ad 默认用fd --hidden查找文件可通过配置文件中的find_command改为find等其他工具编译失败请确认 Rust 版本较新edition 2024 需要较新的 toolchain必要时执行rustup update适合当主力编辑器吗项目仍在快速迭代中官方建议先作为尝鲜和实验用途正式工作请务必保存好备份现在你已经成功从源码编译安装 ad 并打开了第一个文件下一步可以打开docs/tour/目录在 ad 内运行自带的交互式导览或使用:help深入探索。祝你在 ad 中发现更多乐趣【免费下载链接】adan adaptable text editor项目地址: https://gitcode.com/gh_mirrors/ad5/ad创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
