Vim-Autoformat 使用教程

1. 项目介绍

Vim-Autoformat 是一个 Vim 插件，它允许你通过一键操作自动格式化你的代码。该插件利用外部代码格式化程序以达到最佳效果。默认支持多种语言，例如 Python, C++, JavaScript 等，同时也方便自定义或添加新的格式化程序。通过这个插件，你可以极大地提升编码效率，保持代码整洁一致。

2. 项目快速启动

安装依赖

确保你的 Vim 支持 Python（Python 2 或 Python 3）。在 Vim 中运行以下命令检查是否已安装：

:echo has("python3")
:echo has("python2")

对于 Neovim，你需要额外安装 pynvim 并配置路径，例如：

python3 -m pip install pynvim
let g:python3_host_prog="/path/to/python/executable/"

安装 Vim-Autoformat

如果你使用 Vundle，将以下行添加到你的 .vimrc 文件中：

Plugin 'vim-autoformat/vim-autoformat'

然后重启 Vim，运行以下命令来安装插件：

:source %
:PluginInstall

快速格式化代码

在 Vim 中，使用以下快捷键格式化当前文件：

gg=G

这会从文件顶部到底部进行格式化。

3. 应用案例和最佳实践

自定义格式化程序

如果你需要使用特定的格式化程序或者改变默认顺序，可以在 .vimrc 文件中设置，例如：

let g:autoformat苁eters = {
      \ 'cpp': ['clang-format'],
      \ 'javascript': ['prettier', '--stdin-filepath', expand('<afile>')],
      \ }

配合保存动作

你可能希望在每次保存时自动格式化代码，可以添加以下到 .vimrc:

autocmd BufWritePre * call Autoformat()

4. 典型生态项目

• AStyle：C/C++ 格式化工具
• Prettier：通用的代码格式化器，支持多种语言
• Black：Python 代码风格规范自动格式化器

这些工具通常可以与 Vim-Autoformat 结合使用，提供更丰富的代码格式化体验。

以上就是 Vim-Autoformat 的基本使用和配置教程，祝你编码愉快！如有更多需求或遇到问题，可以参考项目官方文档：https://github.com/vim-autoformat/vim-autoformat。