harpoon

⇁ 鱼叉2

这是已弃用的，所有未来的更改都将针对分支harpoon2 。

鱼叉2

状态：4 月 20 日或 6 月 9 日合并到主线（很好）

---

旧版鱼叉自述文件

鱼叉

用最少的按键就能到达您想要的地方。

-- 图片由鲍勃·鲁斯特提供

⇁ 在制品

尽管有几个人使用过，但尚未完全烘烤。如果您遇到任何问题，看到一些您认为令人惊奇的改进，或者只是对鱼叉（或我）有一些反馈，请提出问题！

⇁ 问题：

1. 您正在开发代码库。中、大、小，什么都可以。您发现自己经常访问一小部分文件，并且厌倦了使用模糊查找器， :bnext和:bprev变得过于重复，备用文件并不能完全消除它，等等。
2. 您想要执行一些项目特定的命令或拥有任意数量的可以轻松导航到的持久终端。

⇁ 解决方案：

1. 能够指定或即时标记和创建持久击键以转到所需的文件。
2. 无限的终端和导航。

⇁ 安装

• 需要 neovim 0.5.0+
• 使用您最喜欢的插件管理器安装（本例中为vim-plug ）

Plug ' nvim-lua/plenary.nvim ' " don't forget to add this one if you don't have it yet!
Plug ' ThePrimeagen/harpoon ' 

⇁ 鱼叉

在这里我们将解释如何使用鱼叉的力量：

马克

您标记要稍后重新访问的文件

: lua require ( " harpoon.mark " ). add_file ()

文件导航

查看所有项目标记：

: lua require ( " harpoon.ui " ). toggle_quick_menu ()

您可以在列表中上下移动、输入、删除或重新排序。 q和<ESC>退出并保存菜单

您也可以切换到任何标记，而无需调出菜单，使用下面的标记索引和所需的标记索引

: lua require ( " harpoon.ui " ). nav_file ( 3 )                  -- navigates to file 3

您还可以双向循环列表

: lua require ( " harpoon.ui " ). nav_next ()                   -- navigates to next mark
: lua require ( " harpoon.ui " ). nav_prev ()                   -- navigates to previous mark

从快速菜单中，打开文件：使用 control+v 垂直分割、使用 control+x 水平分割、使用 control+t 创建新选项卡

终端导航

这与文件导航类似，只不过如果指定索引处没有终端，则会创建新终端。

 lua require ( " harpoon.term " ). gotoTerminal ( 1 )             -- navigates to term 1

对终端的命令

命令可以发送到任何终端

 lua require ( " harpoon.term " ). sendCommand ( 1 , " ls -La " )    -- sends ls -La to tmux window 1

可以存储更多命令以供以后快速使用

 lua require ( ' harpoon.cmd-ui ' ). toggle_quick_menu ()       -- shows the commands menu
lua require ( " harpoon.term " ). sendCommand ( 1 , 1 )           -- sends command 1 to term 1

Tmux 支持

tmux 是开箱即用的，只需将'term' with 'tmux'切换即可用作普通终端的直接替代品，如下所示

 lua require ( " harpoon.tmux " ). gotoTerminal ( 1 )             -- goes to the first tmux window
lua require ( " harpoon.tmux " ). sendCommand ( 1 , " ls -La " )    -- sends ls -La to tmux window 1
lua require ( " harpoon.tmux " ). sendCommand ( 1 , 1 )           -- sends command 1 to tmux window 1

sendCommand和goToTerminal还接受任何有效的 tmux 窗格标识符。

 lua require ( " harpoon.tmux " ). gotoTerminal ( " {down-of} " )   -- focus the pane directly below
lua require ( " harpoon.tmux " ). sendCommand ( " %3 " , " ls " )     -- send a command to the pane with id '%3'

一旦你切换到 tmux 窗口，你总是可以切换回 neovim，这是一个小的 bash 脚本，它将切换到正在运行 neovim 的窗口。

在你的tmux.conf （或者任何你有按键绑定的地方），添加这个

bind-key -r G run-shell " path-to-harpoon/harpoon/scripts/tmux/switch-back-to-nvim "

望远镜支持

第一个将鱼叉注册为望远镜扩展

 require ( " telescope " ). load_extension ( ' harpoon ' )

目前望远镜仅支持标记

 :Telescope harpoon marks

⇁ 配置

如果需要配置鱼叉，则必须通过鱼叉设置功能来完成

 require ( " harpoon " ). setup ({ ... })

全局设置

这是所有可用的全局设置及其默认值

 global_settings = {
    -- sets the marks upon calling `toggle` on the ui, instead of require `:w`.
    save_on_toggle = false ,

    -- saves the harpoon file upon every change. disabling is unrecommended.
    save_on_change = true ,

    -- sets harpoon to run the command immediately as it's passed to the terminal when calling `sendCommand`.
    enter_on_sendcmd = false ,

    -- closes any tmux windows harpoon that harpoon creates when you close Neovim.
    tmux_autoclose_windows = false ,

    -- filetypes that you want to prevent from adding to the harpoon list menu.
    excluded_filetypes = { " harpoon " },

    -- set marks specific to each git branch inside git repository
    mark_branch = false ,

    -- enable tabline with harpoon marks
    tabline = false ,
    tabline_prefix = "   " ,
    tabline_suffix = "   " ,
}

预配置的终端命令

预先配置终端命令以供以后使用

 projects = {
    -- Yes $HOME works
    [ " $HOME/personal/vim-with-me/server " ] = {
        term = {
            cmds = {
                " ./env && npx ts-node src/index.ts "
            }
        }
    }
}

⇁ 记录

• 日志写入 nvim 缓存路径中的harpoon.log ( :echo stdpath("cache") )
• 可用的日志级别有trace 、 debug 、 info 、 warn 、 error或fatal 。 warn是默认值
• 日志级别可以使用vim.g.harpoon_log_level设置（必须在setup()之前）
• 使用HARPOON_LOG=debug nvim优先于vim.g.harpoon_log_level 。
• 无效值默认返回warn 。

⇁ 其他

Harpoon 标记与 vim 全局标记有何不同

它们的用途相似，但鱼叉标记在几个关键方面有所不同：

1. 他们自动更新他们在文件中的位置
2. 它们按项目保存。
3. 它们可以手动编辑或替换（交换更容易）

Harpoon 终端背后的动机

1. 我想使用终端，因为我可以 gF 和 gF 来处理终端内执行时产生的任何错误，这些错误不适合调度之类的操作。 （不仅仅是运行测试，还可能是服务器在崩溃之前运行了 X 时间）。
2. 我希望终端是持久的，并且我可以通过一些手指魔法返回到许多终端之一，并重新解析任何不一定与错误相关的执行信息。
3. 我想要可以将命令绑定到终端并无需太多思考即可发送它们。 vim-test 和将它们输入终端之间的某种中间立场（配置 netflix 的电视项目还没有完全构建，并且有很多配置方法）。

对 Harpoon 弹出菜单使用动态宽度

有时默认宽度60不够宽。以下示例演示如何通过设置相对于当前窗口宽度的菜单宽度来配置自定义宽度。

 require ( " harpoon " ). setup ({
    menu = {
        width = vim . api . nvim_win_get_width ( 0 ) - 4 ,
    }
})

表格线

默认情况下，选项卡将使用您的主题的默认主题。您可以通过编辑以下亮点进行自定义：

• 鱼叉未激活
• 鱼叉活跃
• 鱼叉号活跃
• HarpoonNumber不活跃

使其更干净的示例：

 vim . cmd ( ' highlight! HarpoonInactive guibg=NONE guifg=#63698c ' )
vim . cmd ( ' highlight! HarpoonActive guibg=NONE guifg=white ' )
vim . cmd ( ' highlight! HarpoonNumberActive guibg=NONE guifg=#7aa2f7 ' )
vim . cmd ( ' highlight! HarpoonNumberInactive guibg=NONE guifg=#7aa2f7 ' )
vim . cmd ( ' highlight! TabLineFill guibg=NONE guifg=white ' )

结果：

⇁ 社交

有关 Harpoon 的问题，Primeagen 的 Discord 服务器上有一个 #harpoon 频道。

• 不和谐
• 抽搐
• 叽叽喳喳