已棄用

Nvim :help 頁面，使用 tree-sitter-vimdoc 解析器，從 來源 產生。

Nvim
以下列出的項目已棄用：它們將在未來移除。不應在新腳本中使用它們，舊腳本應更新。

已棄用的功能

在 0.11 版本中已棄用 deprecated-0.11

API

nvim_subscribe() 外掛程式必須維護它們自己的「多播」頻道列表。
nvim_unsubscribe() 外掛程式必須維護它們自己的「多播」頻道列表。

LUA

vim.region() 請改用 getregionpos()。
vim.highlight 已重新命名為 vim.hl。
vim.validate(opts: table) 請使用形式 1。請參閱 vim.validate()。

診斷

vim.diagnostic.goto_next() 請改用 vim.diagnostic.jump() 並搭配 {count=1, float=true}。
vim.diagnostic.goto_prev() 請改用 vim.diagnostic.jump() 並搭配 {count=-1, float=true}。
vim.diagnostic.get_next_pos() 請改用 vim.diagnostic.get_next() 的回傳值的 "lnum" 和 "col" 欄位。
vim.diagnostic.get_prev_pos() 請改用 vim.diagnostic.get_prev() 的回傳值的 "lnum" 和 "col" 欄位。
各種函式使用的 "win_id" 參數已被棄用，請改用 "winid" winid
vim.diagnostic.JumpOpts 的 "cursor_position" 參數已重新命名為 "pos"

TREESITTER

TSNode:child_containing_descendant() 請改用 TSNode:child_with_descendant()；除了它可以回傳後代本身之外，其餘都相同。

LSP

vim.lsp.util.jump_to_location 請改用 vim.lsp.util.show_document() 並搭配 {focus=true}。
vim.lsp.buf.execute_command 請改用 Client:exec_cmd()。
vim.lsp.buf.completion 請改用 vim.lsp.completion.trigger()。
vim.lsp.buf_request_all error 鍵在處理程式的結果參數中已重新命名為 err。
vim.lsp.with() 將設定傳遞至 'vim.lsp.buf.*' 中對應的函式。
vim.lsp.handlers 不再支援從客戶端到伺服器的回應處理程式。僅支援從伺服器到客戶端的請求/通知處理程式。
vim.lsp.handlers.signature_help() 請改用 vim.lsp.buf.signature_help()。

在 0.10 版本中已棄用 deprecated-0.10

API

nvim_buf_get_option() 請改用 nvim_get_option_value()。
nvim_buf_set_option() 請改用 nvim_set_option_value()。
nvim_call_atomic() 請改用 nvim_exec_lua()。
nvim_get_option() 請改用 nvim_get_option_value()。
nvim_set_option() 請改用 nvim_set_option_value()。
nvim_win_get_option() 請改用 nvim_get_option_value()。
nvim_win_set_option() 請改用 nvim_set_option_value()。

CHECKHEALTH

health#report_error vim.health.report_error() 請改用 vim.health.error()。
health#report_info vim.health.report_info() 請改用 vim.health.info()。
health#report_ok vim.health.report_ok() 請改用 vim.health.ok()。
health#report_start vim.health.report_start() 請改用 vim.health.start()。
health#report_warn vim.health.report_warn() 請改用 vim.health.warn()。

診斷

使用 :sign-define 或 sign_define() 設定 diagnostic-signs。請改用 vim.diagnostic.config() 的 "signs" 鍵。
vim.diagnostic 函式
vim.diagnostic.disable() 請改用 vim.diagnostic.enable()
vim.diagnostic.is_disabled() 請改用 vim.diagnostic.is_enabled()
舊版簽名：vim.diagnostic.enable(buf:number, namespace:number)

LSP

vim.lsp.util.get_progress_messages() 請改用 vim.lsp.status()。
vim.lsp.get_active_clients() 請改用 vim.lsp.get_clients()。
vim.lsp.for_each_buffer_client() 請改用 vim.lsp.get_clients()。
vim.lsp.util.trim_empty_lines() 請改用 vim.split() 並搭配 trimempty。
vim.lsp.util.try_trim_markdown_code_blocks()
vim.lsp.util.set_lines()
vim.lsp.util.extract_completion_items()
vim.lsp.util.parse_snippet()
vim.lsp.util.text_document_completion_list_to_complete_items()
vim.lsp.util.lookup_section() 請改用 vim.tbl_get()
local keys = vim.split(section, '.', { plain = true })
local  vim.tbl_get(table, unpack(keys))
LUA
vim.loop 請改用 vim.uv。
vim.tbl_add_reverse_lookup()
vim.tbl_flatten() 請改用 Iter:flatten()。
vim.tbl_islist() 請改用 vim.islist()。

選項

"term_background" UI 選項 ui-ext-options 已棄用，且不再填入。背景顏色偵測現在由 Nvim 核心在 Lua 中執行，而不是由 TUI 執行。

TREESITTER

LanguageTree:for_each_child() 請改用 LanguageTree:children() (非遞迴)。

在 0.9 版本中已棄用 deprecated-0.9

API

nvim_get_hl_by_name() 請改用 nvim_get_hl()。
nvim_get_hl_by_id() 請改用 nvim_get_hl()。

TREESITTER

vim.treesitter.language.require_language() 請改用 vim.treesitter.language.add()。
vim.treesitter.get_node_at_pos() 請改用 vim.treesitter.get_node()。
vim.treesitter.get_node_at_cursor() 請改用 vim.treesitter.get_node() 和 TSNode:type()。
以下頂層 Treesitter 函式已移動
vim.treesitter.inspect_language() -> vim.treesitter.language.inspect()
vim.treesitter.get_query_files() -> vim.treesitter.query.get_files()
vim.treesitter.set_query() -> vim.treesitter.query.set()
vim.treesitter.query.set_query() -> vim.treesitter.query.set()
vim.treesitter.get_query() -> vim.treesitter.query.get()
vim.treesitter.query.get_query() -> vim.treesitter.query.get()
vim.treesitter.parse_query() -> vim.treesitter.query.parse()
vim.treesitter.query.parse_query() -> vim.treesitter.query.parse()
vim.treesitter.add_predicate() -> vim.treesitter.query.add_predicate()
vim.treesitter.add_directive() -> vim.treesitter.query.add_directive()
vim.treesitter.list_predicates() -> vim.treesitter.query.list_predicates()
vim.treesitter.list_directives() -> vim.treesitter.query.list_directives()
vim.treesitter.query.get_range() -> vim.treesitter.get_range()
vim.treesitter.query.get_node_text() -> vim.treesitter.get_node_text()

LUA

nvim_exec() 請改用 nvim_exec2()。
vim.pretty_print() 請改用 vim.print()。

在 0.8 或更早版本中已棄用

API

nvim_buf_clear_highlight() 請改用 nvim_buf_clear_namespace()。
nvim_buf_set_virtual_text() 請改用 nvim_buf_set_extmark()。
nvim_command_output() 請改用 nvim_exec2()。
nvim_execute_lua() 請改用 nvim_exec_lua()。
nvim_get_option_info() 請改用 nvim_get_option_info2()。

命令

:rv :rviminfo已棄用，是 :rshada 命令的別名。
:wv :wviminfo已棄用，是 :wshada 命令的別名。

環境變數

$NVIM_LISTEN_ADDRESS
已棄用 的方式，用於
設定伺服器名稱（請改用 --listen 或 serverstart()）
取得伺服器名稱（請改用 v:servername）
偵測父 Nvim（請改用 $NVIM）
如果已指定 --listen，則會忽略此變數。
除非明確由 "env" 選項指定，否則會被 terminal 和 jobstart() 取消設定。範例
call jobstart(['foo'], { 'env': { 'NVIM_LISTEN_ADDRESS': v:servername  } })

事件

BufCreate 請改用 BufAdd。
EncodingChanged 從未觸發；'encoding' 永遠是 "utf-8"。
FileEncoding 從未觸發；等同於 EncodingChanged。
GUIEnter 從未觸發；請改用 UIEnter。
GUIFailed 從未觸發。

按鍵碼

<MouseDown> 請改用 <ScrollWheelUp>。
<MouseUp> 請改用 <ScrollWheelDown>。

函數

buffer_exists() bufexists() 的過時名稱。
buffer_name() bufname() 的過時名稱。
buffer_number() bufnr() 的過時名稱。
file_readable() filereadable() 的過時名稱。
highlight_exists() hlexists() 的過時名稱。
highlightID() hlID() 的過時名稱。
inputdialog() 請改用 input()。
jobclose() chanclose() 的過時名稱
jobsend() chansend() 的過時名稱
last_buffer_nr() bufnr("$") 的過時名稱。
rpcstart() 請改用帶有 {'rpc': v:true} 的 jobstart()。
rpcstop() 請改用 jobstop() 停止任何工作，或使用 chanclose(id, "rpc") 關閉 RPC 通訊而不停止工作。 使用 chanclose(id) 關閉任何 socket。

高亮顯示

hl-VertSplit 請改用 hl-WinSeparator。

LSP 診斷

對於以下每個函數，請改用 vim.diagnostic 中的對應函數（除非另有說明）。 例如，請改用 vim.diagnostic.get()，而不是 vim.lsp.diagnostic.get()。
vim.lsp.diagnostic.clear() 請改用 vim.diagnostic.hide()。
vim.lsp.diagnostic.disable() 請改用 vim.diagnostic.enable()。
vim.lsp.diagnostic.display() 請改用 vim.diagnostic.show()。
vim.lsp.diagnostic.enable()
vim.lsp.diagnostic.get()
vim.lsp.diagnostic.get_all() 請改用 vim.diagnostic.get()。
vim.lsp.diagnostic.get_count() 請改用 vim.diagnostic.count()。
vim.lsp.diagnostic.get_line_diagnostics() 請改用 vim.diagnostic.get()。
vim.lsp.diagnostic.get_next()
vim.lsp.diagnostic.get_next_pos()
vim.lsp.diagnostic.get_prev()
vim.lsp.diagnostic.get_prev_pos()
vim.lsp.diagnostic.get_virtual_text_chunks_for_line() 無替代方案。請使用 vim.diagnostic.config() 提供的選項來自訂虛擬文字。
vim.lsp.diagnostic.goto_next()
vim.lsp.diagnostic.goto_prev()
vim.lsp.diagnostic.redraw() 請改用 vim.diagnostic.show()。
vim.lsp.diagnostic.reset()
vim.lsp.diagnostic.save() 請改用 vim.diagnostic.set()。
vim.lsp.diagnostic.set_loclist() 請改用 vim.diagnostic.setloclist()。
vim.lsp.diagnostic.set_qflist() 請改用 vim.diagnostic.setqflist()。
vim.lsp.diagnostic.show_line_diagnostics() 請改用 vim.diagnostic.open_float()。
vim.lsp.diagnostic.show_position_diagnostics() 請改用 vim.diagnostic.open_float()。
以下函數已棄用，沒有替代方案。這些函數已在內部移動，不再作為 API 的一部分公開。 請改用 vim.diagnostic.config() 和 vim.diagnostic.show()。
vim.lsp.diagnostic.set_signs()
vim.lsp.diagnostic.set_underline()
vim.lsp.diagnostic.set_virtual_text()

LSP 函數

vim.lsp.buf.server_ready() 請根據您的用例改用 LspAttach。「伺服器就緒」不是 LSP 規範的一部分，因此 Nvim LSP 用戶端無法有意義地實作它。「就緒」是模稜兩可的，因為
語言伺服器可能會完成分析工作區，但編輯總是會重新觸發分析/建置。
語言伺服器可以在處理變更時服務某些請求。
vim.lsp.buf.range_code_action() 請使用帶有 range 參數的 vim.lsp.buf.code_action()。
vim.lsp.util.diagnostics_to_items() 請改用 vim.diagnostic.toqflist()。
vim.lsp.util.set_qflist() 請改用 setqflist()。
vim.lsp.util.set_loclist() 請改用 setloclist()。
vim.lsp.buf_get_clients() 請改用帶有 {buffer=bufnr} 的 vim.lsp.get_clients()。
vim.lsp.buf.formatting() 請改用帶有 {async=true} 的 vim.lsp.buf.format()。
vim.lsp.buf.formatting_sync() 請改用帶有 {async=false} 的 vim.lsp.buf.format()。
vim.lsp.buf.range_formatting() 請改用 vim.lsp.formatexpr() 或 vim.lsp.buf.format()。

LUA

vim.register_keystroke_callback() 請改用 vim.on_key()。

正常模式命令

]f [f 與 "gf" 相同。

選項

cpo-< :menu-<special> :menu-special :map-<special> :map-special <> 表示法永遠啟用。
'fe' Vim 6.0 之前的 'fenc'+'enc'；不再使用。
'highlight' 'hl' 無法變更內建 highlight-groups 的名稱。
'langnoremap' 已棄用，是 'nolangremap' 的別名。
'sessionoptions' 旗標 "unix"、"slash" 會被忽略並永遠啟用。
'vi'
'viewoptions' 旗標 "unix"、"slash" 會被忽略並永遠啟用。
'viminfo' 已棄用，是 'shada' 選項的別名。
'viminfofile' 已棄用，是 'shadafile' 選項的別名。
'paste' 'nopaste' 僅貼上即可。™ 'paste' 選項已過時：當您使用終端機或 GUI 的貼上功能貼上文字時（CTRL-SHIFT-v、CMD-v (macOS)、滑鼠中鍵…），會自動處理 paste。啟用「貼上模式」
在插入模式、命令列模式中停用映射。
停用縮寫。
重設 'autoindent'、'expandtab'、'revins'、'ruler'、'showmatch'、'smartindent'、'smarttab'、'softtabstop'、'textwidth'、'wrapmargin'。
將 'formatoptions' 視為空。
停用這些選項的效果
'cindent'
'indentexpr'
'lisp'

UI 擴充

ui-wildmenu 改用 ui-cmdline 和 ui-popupmenu。由 ext_wildmenu ui-option 啟用。發出這些事件
["wildmenu_show", items]
["wildmenu_select", selected]
["wildmenu_hide"]
term_background 未使用。終端機背景顏色現在由 Nvim 核心直接偵測，而非 TUI。

變數

b:terminal_job_pid 改用 jobpid(&channel)。
b:terminal_job_id 改用 &channel。若要在非目前的緩衝區中存取
Lua: vim.bo[bufnr].channel
Vimscript: getbufvar(bufnr, '&channel')
主要
命令索引
快速參考
已棄用功能
在 0.11 中已棄用
API
LUA
診斷
TREESITTER
LSP
在 0.10 中已棄用
API
CHECKHEALTH
診斷
LSP
選項
TREESITTER
在 0.9 中已棄用
API
TREESITTER
LUA
在 0.8 或更早版本中已棄用
API
命令
環境變數
事件
按鍵碼
函數
高亮顯示
LSP 診斷
LSP 函數
LUA
正常模式命令
選項
UI 擴充
變數