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 頻道。

• 不和諧
• 抽搐
• 嘰嘰喳喳