用途:这是 Google 官方 Vim script 编码标准,面向 Vim 插件开发与 Vim 配置维护,帮助写出风格一致、可移植、少冲突的 Vimscript 代码。
主要能力与规则:
- 命名约定:插件函数用 prefix#FunctionName,脚本内函数用 s:FunctionName,脚本变量用 s:variable_name,局部变量用 l:,全局变量用 g:plugin_name,缓冲区变量用 b:,自动命令组用 UpperCamelCase。
- 文件结构:文件顶部声明 scriptencoding utf-8,并用 g:loaded_plugin 守卫防止重复加载。
- 函数:函数定义加 abort 以便快速失败,支持 ... 可选参数,通过 a:0 / a:1 读取。
- 作用域:显式使用 l:、s:、g: 前缀,避免污染全局命名空间。
- 命令与映射:使用 command! 定义自定义命令;映射使用 nnoremap、vnoremap、inoremap 等非递归形式并加 <silent>,可使用 <buffer> 做缓冲区局部映射。
- 自动命令:始终用 augroup 包裹并以 autocmd! 清空,避免重复注册。
- 错误处理:用 try-catch-finally 处理风险操作,用 executable() 检查外部程序,用 has() 与 v:version 检查特性和版本。
- 字符串:区分大小写比较用 ==#,不区分用 ==?,拼接用 .。
适用场景:编写 Vim 插件、维护 Vim 配置文件、Vimscript 代码审查、帮助新贡献者上手插件项目。
使用方式:安装命令为 npx skills add testdino-hq/google-styleguides-skills/vim-script;完整细节与边界案例见 vim-script.md。
限制:资料未提供收费、价格、平台支持范围或其他附加信息。