haskell-vim-now：实践指南
在项目中评估haskell-vim-now，可以先看清用途边界：一行 Haskell Vim 安装。把它放到日常自动化流程中，最容易暴露的是输入边界、依赖和失败处理如果不清楚就很难稳定复用，不能只看演示是否顺利。更实际的做法是用一项范围明确的真实任务完成最小试跑，同时核对配置时间、输出质量、异常信息和维护痕迹，不要直接在关键项目上。对愿意先做小范围验证并复查原始文档的团队来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。
Haskell Vim IDE
不到十分钟，你的 Vim 就会变成一个漂亮的
哈斯克尔天堂。 （别担心，它会备份您的原始数据
配置为 ~/.config/haskell-vim-now/backup/.vimrc.yearmonthdate_time。）它还构建所有必要的支持二进制文件
包括ghcide、hlint、hoogle等。
不再费力地通过插件试图让它们一起工作。 十分钟内你将拥有一个功能齐全、看起来很棒的 Vim 并让你
- 检查类型
- 评估哈斯克尔
- 棉绒和检查
- 操纵标签
- 霍格尔查找
- 无点重构
- 选项卡完成
- 统一码符号
- 突出显示DSLs
- 使用 git
安装
只需下载并运行安装程序：
curl -L https://git.io/haskell-vim-now > /tmp/haskell-vim-now.sh
bash /tmp/haskell-vim-now.sh
WARNING：此命令一旦成功，将_进行备份并删除_您现有的VIM配置（.vim、插件等）。您稍后可以自定义 定制 HVN 配置。
按键绑定和命令
这些命令被组织成逻辑组以帮助您记住 他们。
类型、自动完成、重构和 linting
| <Tab> | Autocomplete with words in file |
| <C-space> | Autocomplete with symbols in your Cabal sandbox |
| ,hr | Apply one refactoring hint at cursor position |
| ,hR | Apply all refactoring suggestions in the file |
| ,hl | Run Haskell linter on file |
| ,hc | Run Haskell compile check on file |
| ,<cr> | Clear type selection |
胡格尔
| ,hh | Run Hoogle on the word under the cursor |
| ,hH | Run Hoogle and prompt for input |
| ,hi | Run Hoogle for detailed information on word under cursor |
| ,hI | Run Hoogle for detailed information and prompt for input |
| ,hz | Close the Hoogle search window |
GHCI 重复
如果你在 MacVim 旁边打开 tmux 终端，那么你可以发送 Vim 对其进行选择。这对于评估 GHCI 中的内容非常有效。
| ,rs | Send selected text to tmux |
| ,rv | Change tmux session, window, and pane attachment |
git
| ,g? | Last-committed files (Monday morning key) |
| ,gs | Git status (fugitive) |
| ,gg | Git grep |
| ,gl | Git log (extradition) |
| ,gd | Git diff |
| ,gb | Git blame |
评论
| gc | Comment / Uncomment selection |
对齐
| ,a= | Align on equal signs |
| ,a, | Align on commas |
| ,a| | Align 垂直 bar |
| ,ap | Align on character of your choice |
分割并查找文件
| ,<space> | Fuzzy file find (CtrlP) |
| ,f | Toggle file browser, find file |
| ,F | Toggle file browser |
| ,sj | Open split below |
| ,sk | Open split above |
| ,sh | Open split leftward |
| ,sl | Open split rightward |
缓冲器
| ,bp | Previous buffer |
| ,bn | Next buffer |
| ,b<space> | Buffer fuzzy finder |
| ,bd | Delete buffer, keep window open (bbye) |
| ,bo | Close all buffers except the current one |
杂项
| ,ma | Enable mouse mode (default) |
| ,mo | Disable mouse mode |
| ,ig | Toggle indentation guides |
| ,u | Interactive undo tree |
| ,ss | Enable spell checking |
| ,e | Open file prompt with current path |
| ,<cr> | Clear search highlights |
| ,r | Redraw screen |
| C-h | Move cursor to leftward pane |
| C-k | Move cursor to upward pane |
| C-j | Move cursor to downward pane |
| C-l | Move cursor to rightward pane (redraw is ,r instead) |
| gq | Format selection using hindent for haskell buffers (par for others) |
| ,y | Yank to OS clipboard |
| ,d | Delete to OS clipboard |
| ,p | Paste from OS clipboard |
（如果您希望恢复C-l的默认屏幕重绘操作
然后将 unmap <c-l> 添加到您的 vimrc.local 中）
定制
安装此配置后，您的 .vimrc 和 .vim 将
处于版本控制之下。不要更改这些文件。相反，添加
你自己的设置为~/.config/haskell-vim-now/vimrc.local.pre，
~/.config/haskell-vim-now/vimrc.local.
添加 Vim 插件
Haskell-Vim-Now 使用 vim-plug 安装插件。它使用以下 vim 配置结构 确定要安装的内容：
call plug#begin('~/.vim/plugged')
" The plugins are named in github short form, for example:
Plug 'junegunn/vim-easy-align'
" All plug statements must be between plug#begin and plug#end
call plug#end()
然而 Haskell-Vim-Now 中的 .vimrc 文件处于版本控制之下
所以你不应该直接编辑它。添加插件你应该做什么
要做的就是将 Plug 语句添加到 ~/.config/haskell-vim-now/plugins.vim 中。
准备好后重新加载 .vimrc 并运行 :PlugInstall 来安装插件。
Neovim 支持
.vimrc配置与Neovim完全兼容，并添加了一些
Neovim 终端模式的特定映射（终端仿真已激活
与 :terminal）。这些映射使 Esc 和 c-[hjkl] 发挥作用
期望他们从正常模式。
Neovim 配置位于 .config/nvim，并且符号链接就像
常规 vim，这意味着您应该只添加自己的设置
~/.config/haskell-vim-now/vimrc.local.pre, ~/.config/haskell-vim-now/vimrc.local
和 ~/.config/haskell-vim-now/plugins.vim。
您可以通过运行 scripts/neovim.sh 快速备份和替换 Neovim 设置
脚本。
Docker镜像
如果您想使用 Docker 进行开发，则可以使用该映像。
docker pull haskell:7.8
docker build -t haskell-vim .
docker run --rm -i -t haskell-vim /bin/bash
如果你想从图像中提取 vim 设置，那很简单
docker build -t haskell-vim .
mkdir ~/.haskell-vim-now
cd ~/.haskell-vim-now
docker run --rm haskell-vim tar -cz -C /root/.haskell-vim-now . > haskell-vim-now.tgz
tar -xzf haskell-vim-now.tgz
但是，有些东西（例如 hoogle 数据库）使用绝对路径并且无法正常工作。
高级安装方法
基本安装
如果您想跳过 haskell 特定组件并想要安装 只是你可以使用的常见 vim 配置：
bash <(curl -sL https://git.io/haskell-vim-now) --basic
在 Nix 构建环境中安装
使用 --nix 参数，如果你想在 nix-shell 中执行 堆栈安装
bash <(curl -sL https://git.io/haskell-vim-now) --nix
故障排除
请参阅此 维基 有关解决安装问题的提示页面。
谢谢你！
非常感谢 贡献者。我特别要感谢 @SX91 重写安装程序和其他重大改进。
