如何用 lazy.nvim 的 dev 模式与 dir 属性加载本地插件进行开发【免费下载链接】lazy.nvim A modern plugin manager for Neovim项目地址: https://gitcode.com/GitHub_Trending/la/lazy.nvim当你正在本地开发一个 Neovim 插件或 fork 了别人的插件时不想让 lazy.nvim 每次都从远端拉取而是直接加载你本地的代码目录改完就能用。lazy.nvim 的 spec 提供了两个属性来完成这件事dir属性直接把插件指向一个本地目录dev模式则让一个远程插件如folke/noice.nvim改用config.dev.path下的本地目录且可以在本地版本和安装版本之间来回切换。本文只覆盖这两种加载方式及其配套的全局配置config.dev。前提Neovim 0.8.0需要 LuaJIT 构建、Git 2.19.0且 lazy.nvim 已经按 安装 一节完成require(lazy).setup(...)配置结构化或单文件方式均可。dir 与 dev两种本地加载方式lazy.nvim 的 Plugin Spec 一节给出的Spec Source表定义了 spec 的来源其中与本地插件相关的属性是dir指向本地插件的目录A directory pointing to a local plugin。dev为true时改用本地插件目录When true, a local plugin directory will be used instead。name自定义插件名用于本地插件的目录名和显示名。一条合法的 spec 必须定义[1]、dir或url三者之一使用dir时它就是插件来源不再需要远端地址。文档给出的两个直接可用的写法-- local plugins need to be explicitly configured with dir { dir ~/projects/secret.nvim },-- local plugins can also be configured with the dev option. -- This will use {config.dev.path}/noice.nvim/ instead of fetching it from GitHub -- With the dev option, you can easily switch between the local and installed version of a plugin { folke/noice.nvim, dev true },两者的区别在于适用对象方式适用场景本地目录dir纯本地插件不在任何远端仓库发布你写什么路径就用什么路径dev true正在开发某个已有插件的本地版本后续可能切回远端安装版由config.dev.path决定见下节dev方式的直接好处是文档明确说的可以方便地在本地版本和安装版本之间切换With the dev option, you can easily switch between the local and installed version of a plugin——删掉dev true即回到从远端拉取。全局配置 config.devpath、patterns 与 fallbackdev true使用哪个目录、匹配规则如何由require(lazy).setup的顶层选项dev控制。文档给出的完整配置中该段如下lua/lazy/core/config.lua中的默认值与之相同require(lazy).setup({ dev { -- Directory where you store your local plugin projects. If a function is used, -- the plugin directory (e.g. ~/projects/plugin-name) must be returned. path ~/projects, -- plugins that match these patterns will use your local versions instead of being fetched from GitHub patterns {}, -- For example {folke} fallback false, -- Fallback to git when local plugin doesnt exist }, -- ... })三个字段的作用path本地插件项目的存放目录默认~/projects。它也可以是函数函数需返回该插件的目录如~/projects/plugin-name。dev true的插件实际目录是{path}/{插件名}文档示例即{config.dev.path}/noice.nvim/。patterns字符串列表。插件的 url 命中其中任一模式如{folke}匹配folke/下的仓库时该插件自动按dev处理使用本地版本而不是从 GitHub 拉取。从源码看匹配是对展开后的插件 url 做子串查找且只在 spec 未显式设置dev时生效lua/lazy/core/meta.lua。fallback本地插件目录不存在时是否回退到 git 安装默认false。目录的解析顺序同样可以在 meta.lua 中核对spec 的dir优先dev true或命中patterns时取{path}/{插件名}path为函数时取其返回值如果fallback true且该本地目录不存在则放弃dev并回退到 git 安装目录否则最终回落到Config.options.root/{插件名}的默认安装目录。也就是说默认配置下即使本地目录不存在插件也会指向该本地目录——所以开始开发前先确保目录存在。按场景选择配置私有/未发布的本地插件用{ dir ... }路径写实际位置即可插件不在远端也没有切回安装版一说。fork 开发已有插件在 spec 上加dev true把本地仓库放在dev.path下并与插件同名noice.nvim示例或把dev.path改成你实际存放目录。同时开发同一作者/组织的多个插件用patterns如{folke}让它们整体使用本地版本无需逐个加dev true。想让目录不存在时自动退回远端把fallback设为true文档注释的语义是 Fallback to git when local plugin doesnt exist。验证加载结果与开发循环文档给出的成功条件是行为层面的dev插件使用{config.dev.path}/{插件名}而不是从 GitHub 拉取This will use {config.dev.path}/noice.nvim/ instead of fetching it from GitHubdir插件则直接以你给的目录作为插件目录。据此可以这样核对确认本地目录存在且命名正确dev模式要求目录是{dev.path}/{插件名}dir模式要求你写的路径可被展开~等写法会被规范化见 config.lua 中对dev.path的Util.norm处理。重启 Neovim 触发一次完整的 spec 解析。若本地目录缺失且fallback true插件会退回 git 安装版这是判断是否真的用了本地目录的一个可观察分支。切换验证删掉 spec 中的dev true或改回dir指向lazy.nvim 会恢复从远端拉取/安装——文档将这种本地/安装版本的来回切换作为dev选项的主要用途。开发过程中的两个配套行为buildspec 的build属性在插件安装或更新时执行支持函数、*.lua文件、:Command、shell 命令字符串或它们的列表rockspec形式则在插件目录下运行luarocks make。本地插件如果需要构建步骤如生成字节码或外部依赖可以在 spec 里照常用build配置。进入插件目录文档的ui.custom_keys示例展示了如何自定义按键在插件目录cwd plugin.dir中打开终端便于在开发时直接操作本地插件文件可参考 配置 一节的完整示例自行添加。如果你的插件还需要最小化测试环境文档的 Developers 一节提供了 Minitminimal init与repro.lua的用法作为本地加载之后的延伸步骤。【免费下载链接】lazy.nvim A modern plugin manager for Neovim项目地址: https://gitcode.com/GitHub_Trending/la/lazy.nvim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何用 lazy.nvim 的 dev 模式与 dir 属性加载本地插件进行开发？
如何用 lazy.nvim 的 dev 模式与 dir 属性加载本地插件进行开发【免费下载链接】lazy.nvim A modern plugin manager for Neovim项目地址: https://gitcode.com/GitHub_Trending/la/lazy.nvim当你正在本地开发一个 Neovim 插件或 fork 了别人的插件时不想让 lazy.nvim 每次都从远端拉取而是直接加载你本地的代码目录改完就能用。lazy.nvim 的 spec 提供了两个属性来完成这件事dir属性直接把插件指向一个本地目录dev模式则让一个远程插件如folke/noice.nvim改用config.dev.path下的本地目录且可以在本地版本和安装版本之间来回切换。本文只覆盖这两种加载方式及其配套的全局配置config.dev。前提Neovim 0.8.0需要 LuaJIT 构建、Git 2.19.0且 lazy.nvim 已经按 安装 一节完成require(lazy).setup(...)配置结构化或单文件方式均可。dir 与 dev两种本地加载方式lazy.nvim 的 Plugin Spec 一节给出的Spec Source表定义了 spec 的来源其中与本地插件相关的属性是dir指向本地插件的目录A directory pointing to a local plugin。dev为true时改用本地插件目录When true, a local plugin directory will be used instead。name自定义插件名用于本地插件的目录名和显示名。一条合法的 spec 必须定义[1]、dir或url三者之一使用dir时它就是插件来源不再需要远端地址。文档给出的两个直接可用的写法-- local plugins need to be explicitly configured with dir { dir ~/projects/secret.nvim },-- local plugins can also be configured with the dev option. -- This will use {config.dev.path}/noice.nvim/ instead of fetching it from GitHub -- With the dev option, you can easily switch between the local and installed version of a plugin { folke/noice.nvim, dev true },两者的区别在于适用对象方式适用场景本地目录dir纯本地插件不在任何远端仓库发布你写什么路径就用什么路径dev true正在开发某个已有插件的本地版本后续可能切回远端安装版由config.dev.path决定见下节dev方式的直接好处是文档明确说的可以方便地在本地版本和安装版本之间切换With the dev option, you can easily switch between the local and installed version of a plugin——删掉dev true即回到从远端拉取。全局配置 config.devpath、patterns 与 fallbackdev true使用哪个目录、匹配规则如何由require(lazy).setup的顶层选项dev控制。文档给出的完整配置中该段如下lua/lazy/core/config.lua中的默认值与之相同require(lazy).setup({ dev { -- Directory where you store your local plugin projects. If a function is used, -- the plugin directory (e.g. ~/projects/plugin-name) must be returned. path ~/projects, -- plugins that match these patterns will use your local versions instead of being fetched from GitHub patterns {}, -- For example {folke} fallback false, -- Fallback to git when local plugin doesnt exist }, -- ... })三个字段的作用path本地插件项目的存放目录默认~/projects。它也可以是函数函数需返回该插件的目录如~/projects/plugin-name。dev true的插件实际目录是{path}/{插件名}文档示例即{config.dev.path}/noice.nvim/。patterns字符串列表。插件的 url 命中其中任一模式如{folke}匹配folke/下的仓库时该插件自动按dev处理使用本地版本而不是从 GitHub 拉取。从源码看匹配是对展开后的插件 url 做子串查找且只在 spec 未显式设置dev时生效lua/lazy/core/meta.lua。fallback本地插件目录不存在时是否回退到 git 安装默认false。目录的解析顺序同样可以在 meta.lua 中核对spec 的dir优先dev true或命中patterns时取{path}/{插件名}path为函数时取其返回值如果fallback true且该本地目录不存在则放弃dev并回退到 git 安装目录否则最终回落到Config.options.root/{插件名}的默认安装目录。也就是说默认配置下即使本地目录不存在插件也会指向该本地目录——所以开始开发前先确保目录存在。按场景选择配置私有/未发布的本地插件用{ dir ... }路径写实际位置即可插件不在远端也没有切回安装版一说。fork 开发已有插件在 spec 上加dev true把本地仓库放在dev.path下并与插件同名noice.nvim示例或把dev.path改成你实际存放目录。同时开发同一作者/组织的多个插件用patterns如{folke}让它们整体使用本地版本无需逐个加dev true。想让目录不存在时自动退回远端把fallback设为true文档注释的语义是 Fallback to git when local plugin doesnt exist。验证加载结果与开发循环文档给出的成功条件是行为层面的dev插件使用{config.dev.path}/{插件名}而不是从 GitHub 拉取This will use {config.dev.path}/noice.nvim/ instead of fetching it from GitHubdir插件则直接以你给的目录作为插件目录。据此可以这样核对确认本地目录存在且命名正确dev模式要求目录是{dev.path}/{插件名}dir模式要求你写的路径可被展开~等写法会被规范化见 config.lua 中对dev.path的Util.norm处理。重启 Neovim 触发一次完整的 spec 解析。若本地目录缺失且fallback true插件会退回 git 安装版这是判断是否真的用了本地目录的一个可观察分支。切换验证删掉 spec 中的dev true或改回dir指向lazy.nvim 会恢复从远端拉取/安装——文档将这种本地/安装版本的来回切换作为dev选项的主要用途。开发过程中的两个配套行为buildspec 的build属性在插件安装或更新时执行支持函数、*.lua文件、:Command、shell 命令字符串或它们的列表rockspec形式则在插件目录下运行luarocks make。本地插件如果需要构建步骤如生成字节码或外部依赖可以在 spec 里照常用build配置。进入插件目录文档的ui.custom_keys示例展示了如何自定义按键在插件目录cwd plugin.dir中打开终端便于在开发时直接操作本地插件文件可参考 配置 一节的完整示例自行添加。如果你的插件还需要最小化测试环境文档的 Developers 一节提供了 Minitminimal init与repro.lua的用法作为本地加载之后的延伸步骤。【免费下载链接】lazy.nvim A modern plugin manager for Neovim项目地址: https://gitcode.com/GitHub_Trending/la/lazy.nvim创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
