Nvim :help
页面,生成 自 源代码 使用 tree-sitter-vimdoc 解析器。
vim-patch.sh
https://github.com/neovim/neovim/blob/master/scripts/vim-patch.sh 查看 Vim 补丁的状态。./scripts/vim-patch.sh -l
git clone https://github.com/neovim/neovim.git
./scripts/vim-patch.sh -l
查看缺少的 Vim 补丁列表。8.0.0123
。./scripts/vim-patch.sh -p 8.0.0123
git log --grep
或 git log -G
搜索 Nvim/Vim 源代码历史(即使是已删除的代码)。例如,要查找 reset_option_was_set
git log -p -G reset_option_was_set
git log
选项(如 --grep
和 -G
)传递给 ./scripts/vim-patch.sh -L
以筛选未合并的 Vim 补丁。例如,要查找 +quickfix
补丁./scripts/vim-patch.sh -L --grep quickfix -- src
vim-patch:8.x.xxxx
(无空格)vim-patch:8.0.0123
(无空格)runtime/
补丁的提示 https://github.com/neovim/neovim/pull/1744#issuecomment-68202876version.c: update
拉取请求,请在提交消息中以以下格式包含不适用的补丁vim-patch:<version-or-commit> vim-patch:<version-or-commit> ...
<version-or-commit>
是有效的 Vim 版本(如 8.0.0123
)或提交 ID(SHA)。每个补丁都占一行。./scripts/vim-patch -p <na-patch> ./scripts/vim-patch -p <na-patch> ... ./scripts/vim-patch -P <patch> git rebase -i master
:scriptversion
相关的任何内容。(Nvim 仅支持 Vimscript 版本 1。)请注意,标记为 Vim9:
的补丁可能仍然包含对代码库其他部分的适用修复,因此需要单独检查这些补丁。testdir/Makefile
的更新通常不适用,因为 Makefile 会隐式地查找 https://github.com/neovim/neovim/commit/8a677f8a4bff6005fa39f090c14e970c3dfdbe6e#diff-b3c6ad6680a25a1b42095879e3a87104R52 所有 test_*.vim
文件。*.proto
更改:Nvim 会自动生成函数原型#ifdef
调整:例如,Vim 决定为所有平台启用 FEAT_VISUAL
- 但 Nvim 已经这样做了。添加新的 FEAT_
保护也不适用于 Nvim。src/Make_*
、src/testdir/Make__*
if_*.c
更改:if_python.c
等已被删除。term.c
更改:Nvim TUI 使用 libtermkey
读取终端序列;Vim 的 term.c
已被删除。job
补丁:不兼容的 API 和实现src/channel_*
、src/job_*
、src/testdir/test_channel_*
、src/testdir/test_job_*
:terminal
补丁:不兼容的 API 和实现src/terminal_*
、src/testdir/test_terminal_*
defaults.vim
补丁src/gui_*
、src/gvim_*
、src/GvimExt/*
、src/testdir/test_gui*
balloon
更改:Nvim 不支持气球功能src/beval_*
、src/testdir/test_balloon_*
test_popupwin.vim
、test_popupwin_textprop.vim
的屏幕截图测试:https://github.com/neovim/neovim/pull/12741#issuecomment-704677141src/json*
、src/testdir/test_json.vim
test_restricted.vim
中的受限模式已在 https://github.com/neovim/neovim/pull/11996 中删除test_prompt_buffer.vim
中的许多测试都需要不兼容的 Vim 功能,例如 channel
;它们应该仍然被包含,但应该被跳过Filelist
、README
、INSTALL
、src/nvim/version.c
中的 Vim 补丁列表会自动更新 https://github.com/neovim/neovim/pull/7780,基于 Nvim git 日志中 vim-patch:xxx
标记的存在。src/nvim/version.c
。scripts/vim-patch.sh -p
故意省略 version.c
,以避免合并冲突并节省移植补丁的时间。scripts/vimpatch.lua
)仅识别 vim-patch:8.0.1206
这样的标记,而不是 vim-patch:<hash>
。memory.c
https://github.com/neovim/neovim/blob/master/src/nvim/memory.c。----------------------------------------------------------------------- Deprecated or removed Replacement ----------------------------------------------------------------------- vim_free xfree VIM_CLEAR(&foo) XFREE_CLEAR(foo) malloc alloc lalloc lalloc_id ALLOC_ONE xmalloc calloc lalloc_clear xcalloc realloc vim_realloc xrealloc mch_memmove memmove vim_memset copy_chars copy_spaces memset vim_strbyte strchr vim_strncpy strncpy xstrlcpy/xmemcpyz vim_strcat strncat xstrlcat VIM_ISWHITE ascii_iswhite IS_WHITE_OR_NUL ascii_iswhite_or_nul vim_isalpha mb_isalpha vim_isNormalIDc ascii_isident vim_islower vim_isupper mb_islower mb_isupper vim_tolower vim_toupper mb_tolower mb_toupper mb_ptr2len utfc_ptr2len mb_ptr2len_len utfc_ptr2len_len mb_char2len utf_char2len mb_char2bytes utf_char2bytes mb_ptr2cells utf_ptr2cells mb_ptr2cells_len utf_ptr2cells_len mb_char2cells utf_char2cells mb_off2cells utf_off2cells mb_ptr2char utf_ptr2char mb_head_off utf_head_off mb_tail_off utf_cp_bounds mb_strnicmp2 utf_strnicmp MB_STRNICMP2 utf_strnicmp mb_lefthalve grid_lefthalve mb_fix_col grid_fix_col utf_off2cells grid_off2cells ml_get_curline get_cursor_line_ptr ml_get_cursor get_cursor_pos_ptr ml_get_curline_len get_cursor_line_len ml_get_cursor_len get_cursor_pos_len screen_char ui_line screen_line grid_put_linebuf screen_* (most functions) grid_* update_prepare, update_finish #9484 removed; use update_screen only ARRAY_LENGTH ARRAY_SIZE vim_strsave_escape_csi vim_strsave_escape_ks vim_unescape_csi vim_unescape_ks gettail path_tail mch_isFullName path_is_absolute script_do_profile profile_init -----------------------------------------------------------------------
mb_
函数时,请务必注意 utf_
和 utfc_
之间的区别。此外,间接调用语法 (*mb_ptr2len)(...)
应替换为普通的函数调用 utfc_ptr2len(...)
。----------------------------------------------------------------------- Data type Format (Vim source) Portable format (Nvim source) ------------ ----------------------- ---------------------------------- long long "%lld" "%" PRId64 size_t "%ld" "%zu" linenr_T "%ld" "%" PRIdLINENR -----------------------------------------------------------------------
ga_init2
已重命名为 ga_init
,而原始的 ga_init
已经消失了。src/testdir/*.in
)应该转换为 Lua 测试(请参阅 #1286 https://github.com/neovim/neovim/issues/1286 和 #1328 https://github.com/neovim/neovim/pull/1328)。请参阅迁移遗留测试的清单 https://github.com/neovim/neovim/blob/master/test/README.md#checklist-for-migrating-legacy-tests。src/testdir/*.vim
)转换为 Lua。"新式" Vim 测试比旧测试速度更快,将它们转换为 Lua 需要花费时间和精力,这些时间和精力最好花在其他地方。只需将它们复制到 test/old/testdir/*.vim
即可。enc_utf8
或 has_mbyte
的条件已经过时(只有 "true" 案例适用)。FEAT_GUI
启用时,才需要检查预读缓冲区中的 CSI
。在 Nvim 中,预读缓冲区中的 CSI
没有特殊含义。(另请参阅 https://github.com/neovim/neovim/pull/16936)list_T
和 listitem_T
类型)的管理已在 https://github.com/neovim/neovim/pull/7708/ 中更改。有一个针对 "旧" 用法的 lint,但以下是最重要的更改。list_T list
:一个列表listitem_T li
:list
中的一个项int val
:lv_copyID
的值-------------------------------------------------------------------------------------- Old New Comment ------------------------------- ------------------------------------------------------ list->lv_first tv_list_first(list) list->lv_last tv_list_last(list) li->li_next TV_LIST_ITEM_NEXT(list, li) To be avoided if possible, must use list which li belongs to. li->li_prev TV_LIST_ITEM_PREV(list, li) To be avoided if possible, must use list which li belongs to. Suggestion by @ZyX-l: Use TV_LIST_ITER or indexing instead of the previous two calls. list->lv_len tv_list_len(list) list->lv_lock tv_list_locked(list) &li->li_tv TV_LIST_ITEM_TV(li) list->lv_refcount++ tv_list_ref(list) val = list->lv_copyID val = tv_list_copyid(list) list->lv_copyID = val tv_list_set_copyid(list, val) for (li = list->lv_first; TV_LIST_ITER_CONST(list, li, Use TV_LIST_ITER(...) if you need to li != NULL && another_cond; { if (another_cond) {break;} code}) modify list items (note: assigning copyID is also modification and this happens li = li->li_next) code always when recursively traversing a list). --------------------------------------------------------------------------------------
typval.h
和 typval.c
。{Only when compiled with ...}
:绝大多数功能已成为非可选的(请参阅 https://github.com/neovim/neovim/wiki/Introduction)$VIMRUNTIME/lua/vim/filetype.lua
)。逻辑编码在三个表中,按优先级顺序排列(返回第一个匹配项):1. filename
用于字面完整路径或基本名称查找;2. pattern
用于将文件名或路径与 lua-patterns 匹配,经过优化以实现快速查找;3. extension
用于字面扩展名查找。$VIMRUNTIME/lua/vim/filetype/detect.lua
中实现。"*[mM]akefile" regex -> "makefile", "Makefile" filenames "*.js\c" regex -> "js", "jS", "Js", "jS" extensions模式匹配有一些区别
"*/debian/changelog" -> "/debian/changelog$" "*/bind/db.*" -> "/bind/db%."
/
时没有特殊的匹配行为。"/etc/"
、"/log/"
);"/conf"
、"git/"
);"nginx"
)。".*/etc/a2ps/.*%.cfg"
"/etc/"
或 "%.cfg$"
"%."
(快速但不具体)或 "/a2ps/.*%."
(具体但缓慢)