xfy
9c8deeafc8
- Move lsp.lua, pick.lua, treesitter.lua, git.lua to lua/plugins/ - Update all require() paths in pack.lua and init.lua - Unify code style: tab indentation, line length control, empty braces - Add detailed Chinese module documentation to all config files - Add grug-far.nvim plugin with <leader>sr binding - Enable vim._core.ui2 for Neovim 0.12+ UI enhancements - Disable additional built-in plugins to reduce startup overhead Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
70 lines
3.1 KiB
Lua
70 lines
3.1 KiB
Lua
-- =============================================================================
|
||
-- 用户自定义命令 (lua/usercmds.lua)
|
||
-- =============================================================================
|
||
-- 定义 Neovim 命令行可用的自定义命令，封装 vim.pack API 的日常操作。
|
||
--
|
||
-- Neovim 0.12+ 内置 vim.pack 插件管理，提供：
|
||
-- vim.pack.add(urls, opts) - 添加/安装插件
|
||
-- vim.pack.del(names) - 删除插件
|
||
-- vim.pack.update(names?) - 更新插件
|
||
--
|
||
-- 以下命令是对这些 API 的友好封装，支持命令行参数解析。
|
||
-- =============================================================================
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- :PackAdd — 添加插件
|
||
-- ---------------------------------------------------------------------------
|
||
-- 用法：:PackAdd user/repo1 user/repo2 ...
|
||
-- 示例：:PackAdd stevearc/conform.nvim tpope/vim-fugitive
|
||
--
|
||
-- 原理：
|
||
-- 将命令行参数（opts.fargs，已按空格分割的字符串数组）
|
||
-- 直接传递给 vim.pack.add()。
|
||
-- vim.pack 会从 GitHub 下载插件到 stdpath("data")/site/pack/core/opt/。
|
||
--
|
||
-- nargs = "+" 表示至少需要 1 个参数。
|
||
vim.api.nvim_create_user_command("PackAdd", function(opts)
|
||
vim.pack.add(opts.fargs)
|
||
end, { nargs = "+", desc = "添加插件 (:PackAdd user/repo1 user/repo2)" })
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- :PackDel — 删除插件
|
||
-- ---------------------------------------------------------------------------
|
||
-- 用法：:PackDel plugin1 plugin2 ...
|
||
-- 示例：:PackDel conform.nvim vim-fugitive
|
||
--
|
||
-- 注意：
|
||
-- 参数是插件目录名（即 repo 名），不是完整 URL。
|
||
-- Neovim 0.13 Nightly 已内置此命令，这里为 0.12 提供兼容。
|
||
--
|
||
-- nargs = "+" 表示至少需要 1 个参数。
|
||
vim.api.nvim_create_user_command("PackDel", function(opts)
|
||
vim.pack.del(opts.fargs)
|
||
end, { nargs = "+", desc = "删除插件 (:PackDel plugin1 plugin2)" })
|
||
|
||
-- ---------------------------------------------------------------------------
|
||
-- :PackUpdate — 更新插件
|
||
-- ---------------------------------------------------------------------------
|
||
-- 用法：
|
||
-- :PackUpdate → 更新所有插件
|
||
-- :PackUpdate name1 name2 ... → 更新指定插件
|
||
--
|
||
-- 原理：
|
||
-- 检查 opts.args 是否包含非空白字符（%S 匹配任意非空白）。
|
||
-- 如果有参数，按空白分割为数组后逐个更新；
|
||
-- 如果无参数，调用无参版本更新所有插件。
|
||
--
|
||
-- nargs = "*" 表示接受 0 个或多个参数。
|
||
vim.api.nvim_create_user_command("PackUpdate", function(opts)
|
||
-- 检查是否有传入任何参数（包含非空白字符）
|
||
if opts.args:match("%S") then
|
||
-- 按空白字符分割参数，trimempty 去除空字符串
|
||
local plugins = vim.split(opts.args, "%s+", { trimempty = true })
|
||
-- 仅更新指定的插件
|
||
vim.pack.update(plugins)
|
||
else
|
||
-- 无参数，更新所有插件
|
||
vim.pack.update()
|
||
end
|
||
end, { nargs = "*", desc = "更新所有插件或指定插件" })
|