企业官网建设流程全解析

• 开发工具

本指南以 YADR（Yet Another Dotfile Repo）的 doc/vim/coding.md 为核心，系统讲解该仓库内置的 14+ 个编码辅助插件——从注释（tComment）、自动补全（neocomplete）、代码片段（snipMate），到 Rails/Ruby 开发全家桶（rails.vim、rake.vim、vim-bundler）以及 Git 集成（fugitive、gitv）。读完本文，你将掌握这些插件在 YADR 中的默认按键映射、底层配置方式，并能通过:map/:verbose map自主排查按键冲突、按需定制属于自己的编码环境。

一、YADR 的编码插件从哪来：Vundle 分类加载机制

在深入每个插件之前，先理解 YADR 的插件组织方式。YADR 使用 Vundle 管理插件，vim/vundles.vim 是插件入口文件，它按类别拆分成多个.vundle文件，通过runtime命令加载：

runtime ruby.vundle runtime languages.vundle runtime git.vundle runtime appearance.vundle runtime textobjects.vundle runtime search.vundle runtime project.vundle runtime vim-improvements.vundle

本文涉及的编码辅助插件分散在 vim/vundles/ruby.vundle、vim/vundles/languages.vundle、vim/vundles/git.vundle 和 vim/vundles/vim-improvements.vundle 中。

安装后，~/.yadr/vim/settings/下的每个插件配置文件由 vim/settings.vim 统一遍历加载——它会跳过与当前系统不匹配的yadr-keymap-mac.vim/yadr-keymap-linux.vim，其余.vim文件全部source。因此，你在文中看到的每个配置片段都有真实落盘文件可查。

注意：仓库主配置在 vimrc 中将<Leader>设为逗号（let mapleader=","），所以下文几乎所有快捷键都以,开头。想要自定义某个键位，可在~/.vimrc.after中覆盖（参见 doc/vim/override.md）。

二、快速注释：tComment 的gcc/gcp

coding.md开门见山推荐了 tComment：gcc注释当前行，gcp注释当前块。

tComment 通过 vim/vundles/vim-improvements.vundle 引入（Bundle "tomtom/tcomment_vim.git"）。YADR 在此基础上做了一处关键扩展：tComment 默认只映射gcc，而 vim/settings/tComment.vim 显式补充了段落注释映射：

" extensions for tComment plugin. Normally " tComment maps 'gcc' to comment current line " this adds 'gcp' comment current paragraph (block) " using tComment's built in <c-_>p mapping nmap <silent> gcp <c-_>p

这意味着：

• gcc— 注释/取消注释当前行（tComment 原生映射）；
• gcp— 注释/取消注释当前段落（通过 tComment 内置的<C-_>p映射实现）。

tComment 的核心价值在于它是基于文件类型感知注释符的：在 Ruby 里用#，在 VimL 里用"，在 HTML/CSS 里用<!-- -->//* */，无需手动切换。README 中还提到Cmd-/（Linux 下为Alt-/）也可切换注释，其本质同样是 tComment 的gcc。

三、Rails / Ruby 开发全家桶：rails.vim、rake.vim、ruby.vim、vim-bundler

coding.md用了整整三行强调 Rails/Ruby 体系，这在 YADR 中是投入最大的部分。

3.1 rails.vim：Rails 开发的必备插件

coding.md对 rails.vim 的评价是"syntax highlighting, gf (goto file) enhancements, and lots more. should be required for any rails dev"（应成为每位 Rails 开发者的必备）。它在 vim/vundles/ruby.vundle 中通过Bundle "tpope/vim-rails.git"引入。

rails.vim 的核心能力包括:Rcontroller、:Rview等:R<Tab>家族命令。YADR 在 vim/settings/rails.vim 中为最常用的"视图 ↔ 控制器"切换提供了两个快速映射：

" Better key maps for switching between controller and view nnoremap ,vv :Eview<cr> nnoremap ,cc :Econtroller<cr>

配合 README 中记录的相关按键，Rails 开发者的日常操作是：

• ,vv— 快速切换到对应视图（:Eview）；
• ,cc— 快速切换到对应控制器（:Econtroller）；
• ,jm/,jc/,jh— 分别跳转到 model、controller、helper（CtrlP标签搜索）；
• Ctrl-s— 在分屏中打开对应的 spec 文件（对 fast_spec 目录同样有效）。

3.2 rake.vim：非 Rails 项目的"rails.vim"

coding.md称 rake.vim "like rails.vim but for non-rails projects. makes:Rtagsand other commands just work"（与 rails.vim 类似，但服务于非 Rails 项目，让:Rtags等命令直接可用）。它同样来自tpope/vim-rake.git（见 vim/vundles/ruby.vundle）。对于使用 Rake 组织任务的普通 Ruby 项目，rake.vim 提供了与 rails.vim 一致的命令家族（如:Rtags生成标签、:Rake执行任务），让"非 Rails 的 Ruby 项目"也能享受同等便利。

3.3 ruby.vim：Ruby 通用增强

coding.md提到 ruby.vim 提供 "lots of general enhancements for ruby dev"。仓库通过Bundle "vim-ruby/vim-ruby.git"引入（见 vim/vundles/ruby.vundle），它为 Ruby 提供更精确的语法高亮、缩进和移动命令，并为后续的补全、重构插件提供语言基础。同文件中的vim-ruby-refactoring（ecomba/vim-ruby-refactoring）则带来,rem（提取方法）、,rel（提取 let 语句）等重构命令。

3.4 vim-bundler：在 gem 源码与项目间穿梭

coding.md单独列出 vim-bundler，用于 "work with bundled gems"。README 给出其用法：:Bopen [gem name]即可跳转到任意 bundled gem 的源码目录（例如:Bopen rspec）。该插件在 vim/vundles/ruby.vundle 中声明为Bundle "tpope/vim-bundler"，其命令与:e同构，熟悉文件打开方式的开发者零成本上手。

3.5 配套：RSpec 运行与语法高亮

虽然不在coding.md的 14 行列表中，但 Rails 工作流离不开 RSpec。YADR 在 vim/vundles/ruby.vundle 中引入了rspec.vim与vim-iterm-rspec，并在 vim/settings/iterm-rspec.vim 提供一键运行映射：

nnoremap ,rs :RunItermSpec<cr> nnoremap ,rl :RunItermSpecLine<cr> nnoremap ,ss :RunItermSpringSpec<cr> nnoremap ,sl :RunItermSpringSpecLine<cr> nnoremap zl :RunItermZeusSpecLine<cr> nnoremap zs :RunItermZeusSpec<cr>

• ,rs/,rl— 在 iTerm 中运行整个 spec 文件 / 当前行所在的 spec；
• ,ss/,sl— 使用spring rspec运行（spring 缓存 Rails 环境以加速，需安装 spring gem）；
• zs/zl— 使用 Zeus 运行。

vim/settings/rspec.vim 还提供了两个便捷函数：,rxit将pending(...)块一键改为xit（跳过测试），\bf/\sp快速插入before { }/specify { }包裹。

四、智能补全：neocomplete + Ctrl-Space

coding.md提到 "necomplcache - intelligent and fast complete as you type, and added Command-Space to select a completion (same as Ctrl-N)"。这里文档写作时沿用了旧名，YADR 实际引入的是其继任者neocomplete（Shougo/neocomplete.git，见 vim/vundles/vim-improvements.vundle），配置集中在 vim/settings/neocomplete.vim。

完整配置如下：

let g:acp_enableAtStartup = 0 let g:neocomplete#enable_at_startup = 1 let g:neocomplete#enable_camel_case = 1 let g:neocomplete#enable_smart_case = 1 " Default # of completions is 100, that's crazy. let g:neocomplete#max_list = 5 " Set minimum syntax keyword length. let g:neocomplete#auto_completion_start_length = 3 " Map standard Ctrl-N completion to Ctrl-Space inoremap <C-Space> <C-n> " This makes sure we use neocomplete completefunc instead of " the one in rails.vim, otherwise this plugin will crap out. let g:neocomplete#force_overwrite_completefunc = 1 " Define keyword. if !exists('g:neocomplete#keyword_patterns') let g:neocomplete#keyword_patterns = {} endif let g:neocomplete#keyword_patterns['default'] = '\h\w*' " Enable omni completion. autocmd FileType css setlocal omnifunc=csscomplete#CompleteCSS autocmd FileType html,markdown setlocal omnifunc=htmlcomplete#CompleteTags autocmd FileType javascript setlocal omnifunc=javascriptcomplete#CompleteJS autocmd FileType python setlocal omnifunc=pythoncomplete#Complete autocmd FileType xml setlocal omnifunc=xmlcomplete#CompleteTags autocmd FileType ruby setlocal omnifunc=rubycomplete#Complete

几个值得展开的参数细节：

补全的触发方式是Ctrl-Space（等价于原生Ctrl-N的:inoremap <C-Space> <C-n>），这也是 README 中 "Ctrl-Space to autocomplete" 一说的来源。按文件类型挂载的 omni 补全（omnifunc）覆盖 css、html/markdown、javascript、python、xml、ruby 六类文件。

环境前提：README 明确提示，neocomplete 依赖支持 Lua 的 Vim/MacVim。若使用 RVM 管理的 Ruby 编译终端 Vim 且不带 Lua，可能触发段错误，需改用系统 Ruby 重装（见 README.md 的 "Macvim troubles with Lua" 一节）。

五、代码片段：snipMate + vim-snippets

coding.md写道："snipMate - offers textmate-like snippet expansion + snippets collection (honza/vim-snippets). Try hitting TAB after typing a snippet"（提供 TextMate 风格的片段展开，并附带 honza/vim-snippets 片段库，输入片段名后按 TAB 即可展开）。

插件来源（见 vim/vundles/languages.vundle）：

Bundle 'garbas/vim-snipmate.git' Bundle 'honza/vim-snippets'

• vim-snipmate是片段引擎，提供 TextMate 风格的占位符跳转（TAB在片段占位符之间移动）；
• honza/vim-snippets是社区维护的庞大片段库，覆盖 Ruby、Rails、JavaScript、HTML 等几十种语言，也是coding.md提到的 jasmine 测试片段（it、before等）的来源之一。

YADR 在 vim/settings/snipmate.vim 中做了唯一一处定制——显式指定 snippet 版本以消除启动提示：

" Explicitly set g:snipMate.snippet_version to remove start up message let g:snipMate = { 'snippet_version' : 0 }

六、前端与多语言支持：JavaScript / jQuery / CoffeeScript / Stylus / Markdown

coding.md后半部分集中介绍了前端语言支持插件，它们在 vim/vundles/languages.vundle 中成体系声明。

6.1 jasmine.vim：JavaScript 单元测试

coding.md介绍："support for jasmine javascript unit testing, including snippets for it, before, etc.."（支持 Jasmine JavaScript 单元测试，内置it、before等测试片段）。它让 Vim 中编写 Jasmine 测试时拥有语法高亮与快捷片段。

6.2 vim-javascript-syntax、vim-jquery：更好的高亮

coding.md用 "better highlighting" 概括二者。仓库实际引入的是pangloss/vim-javascript（现代维护版本），并叠加了 vim/settings/es6.vim 对 ES6 的支持：

" Automatically treat .es6 extension files as javascript autocmd BufRead,BufNewFile *.es6 setfiletype javascript

此外 vim/settings/gh-markdown.vim 把*.md/*.markdown文件映射为 GitHub Flavored Markdown 类型：

augroup markdown au! au BufNewFile,BufRead *.md,*.markdown setlocal filetype=ghmarkdown augroup END

6.3 TagHighlight：高亮类名与方法名

coding.md提到 "TagHighlight - highlights class names and method names"。该插件基于 ctags 生成的标签，在编辑时对类名、方法名做视觉高亮，帮助开发者快速扫描代码结构。README 也强调,f跳转到定义依赖exuberant ctags已安装。YADR 在 Rakefile 中通过 Homebrew 预装ctags，并在 vim/settings/autotag.vim 中排除了部分难以解析的文件类型：

" AutoTag " Seems to have problems with some vim files let g:autotagExcludeSuffixes="tml.xml.text.txt.vim"

6.4 vim-coffeescript 与 vim-stylus

coding.md分别介绍：vim-coffeescript "support for coffeescript, highlighting"（CoffeeScript 语法支持与高亮）、vim-stylus "support for stylus css language"（Stylus CSS 预处理器支持）。二者均为对应语言的语法高亮插件，让 YADR 在 Ruby 时代也能覆盖当时流行的前端技术栈。

6.5 配套语法检查：syntastic

coding.md虽未直接提及 syntastic，但它与多语言高亮配合使用，且配置完整保存在 vim/settings/syntastic.vim：

let g:syntastic_enable_signs=1 let g:syntastic_auto_jump=0 let g:syntastic_auto_loc_list=1 let g:syntastic_quiet_messages = {'level': 'warnings'} " Default to eslint. If you need jshint, you can override this in " ~/.vimrc.after let g:syntastic_javascript_checkers = ['eslint']

• 保存文件时自动做语法检查（:signs标记错误位置）；
• JavaScript 默认使用eslint检查器，需要 jshint 可在~/.vimrc.after覆盖g:syntastic_javascript_checkers；
• 通过s:FindRubyExec()函数自动探测 RVM 环境下的 Ruby 可执行文件，避免 Ruby 检查器路径错误。

七、Git 集成：fugitive 与 gitv

coding.md引用了一句流传甚广的评价："a git wrapper so awesome, it should be illegal..."（好用到违法的 Git 封装），并给出了完整实战流程。

7.1 fugitive：:Gstatus为核心的状态管理

fugitive 来自tpope/vim-fugitive（见 vim/vundles/git.vundle）。coding.md演示的完整工作流如下：

1. 运行:Gstatus打开 Git 状态缓冲区；
2. 在状态缓冲区按-将文件加入/移出暂存区（index）；
3. 按d查看该文件的 diff；
4. 冲突合并时使用git mergetool或gmt，以 Vim 作为合并工具——左侧缓冲区是你的分支，右侧是传入的更改，中间是工作副本；
5. 光标移到左/右侧缓冲区后按dp把更改放入中间（dp即:diffput）。

YADR 对 fugitive 做了两层增强：

vim/settings/fugitive.vim 定义了,dg/,dp对应:diffget/:diffput：

" For fugitive.git, dp means :diffput. Define dg to mean :diffget nnoremap <silent> ,dg :diffget<CR> nnoremap <silent> ,dp :diffput<CR>

vim/settings/vim-fugitive.vim 则处理两个易用性细节：

" 在 git blob/tree 缓冲区中，用 .. 回到上一级目录 autocmd User fugitive \ if get(b:, 'fugitive_type', '') =~# '^\%(tree\|blob\)$' | \ nnoremap <buffer> .. :edit %:h<CR> | \ endif " fugitive 打开的 git 对象缓冲区在关闭后自动删除，避免缓冲区列表被淹没 autocmd BufReadPost fugitive://* set bufhidden=delete

• 在浏览 Git 对象（blob/tree）时按..即可进入父目录；
• 所有fugitive://*缓冲区设置bufhidden=delete，防止每次查看 git 对象都产生大量残留缓冲区。

7.2 gitv：更好的 Git 日志浏览器

coding.md建议 "use:gitvfor a better git log browser"。gitv 在 vim/vundles/git.vundle 中声明为Bundle "gregsexton/gitv"，它把git log渲染为可导航的分支图视图，支持在提交间按Enter查看 diff、o在新缓冲区打开文件，弥补了原生:Glog体验的不足。

八、按键冲突排查：:map与:verbose map

YADR 为 90+ 插件统一配置快捷键，难免出现"某个键为什么是这个行为"的疑问。doc/vim/keymaps.md 给出了官方排查方法：

:map [keycombo] " 例如 :map <C-\>，查看某个键当前映射到哪 :verbose map [keycombo] " 额外显示该映射是在哪个文件设置的

• 省略键位直接运行:map，将列出所有映射；
• :verbose map会注明映射来源文件（例如vim/settings/...），对定位"谁改了我的键"极有价值；
• 同样适用于nmap、imap、vmap等模式限定命令。

这解释了为什么前面每一个快捷键都能在 vim/settings/ 下找到对应文件——YADR 的设计原则就是"按插件拆分配置文件 + 统一<Leader>,前缀"，让映射来源清晰可查。

九、个性化定制：在 YADR 之上做增量修改

本文所有插件均通过 Vundle 引入，自定义方式分三个层次：

1. 调整已有插件参数：在~/.vimrc.after中覆盖即可。例如 vim/settings/syntastic.vim 注释明确写着 "If you need jshint, you can override this in~/.vimrc.after"。
2. 增加新插件：编辑~/.vim/.vundles.local（vim/vundles.vim 第 32–36 行会在加载完分类文件后source它），无需 fork 仓库即可追加Bundle声明。
3. 新增快捷键：参考 vim/settings.vim 的自动加载机制，把自定义映射放进~/.vim/settings/下的独立文件，或直接写入~/.vimrc.after。

更新插件则沿用 README 的升级流程：进入~/.yadr执行git pull --rebase后运行rake update。

十、小结：一图看懂 YADR 编码插件分工

这套体系的整体思路是：每个插件只解决一个具体问题，YADR 为它提供贴合实战的默认配置与<Leader>,前缀快捷键，并保证所有映射来源可追溯。当你对某个键位有疑问时，coding.md给出的插件清单、vim/vundles.vim 的加载入口、vim/settings/ 的逐插件配置，加上:verbose map三件套，足以让你快速理解并改造自己的 Vim 编码环境。

• 开发工具