1. 为什么 vi 里的 tab 和空格总在打架如果你写过 Python或者维护过 Makefile大概率被 tab 和空格混用坑过一次。Python 3 早就禁止 tab 和空格混着缩进一旦混用直接抛TabError: inconsistent use of tabs and spaces in indentation而 Makefile 反过来命令行前面必须是真正的 tab你手一抖换成空格make立刻报missing separator。同一个项目里有人用 4 空格有人用 2 空格有人直接按 tab代码 review 时 diff 一片红看着就头疼。vi 和 vim 作为 Linux 下最常打交道的编辑器默认行为其实挺原始tab 就是 tab宽度由tabstop决定但插入的字符仍然是制表符本身。很多人只知道在.vimrc里写set ts4以为这样 tab 就变成 4 个空格了结果打开文件一看缩进还是 tab只是显示宽了而已。真正让 tab 落盘成空格的开关是expandtab这个参数才是关键。这篇就围绕 vi/vim 场景给你一套可以直接复制的settings.json配置骨架把expandtab、tabstop、shiftwidth、softtabstop这几个容易搞混的项一次讲清楚再配合 TaoToken 统一 Key 的接入位置说明最后用:set list和缩进测试动作验证 tab 是否真的转成了空格。适合本地开发、远程 SSH 编辑、以及需要统一团队缩进风格的工程师。2. TaoToken 统一 Key 的前置准备在动手改配置之前先把工具链的入口理清楚。TaoToken 的官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 通道地址是 https://taotoken.net/api 这两个地址建议先记下来后面配置里会用到。统一 Key 的意思是你不需要为每个模型或每个工具单独申请一套凭证在 TaoToken 控制台生成一个 Key就能在多个接入点复用。对于 vi/vim 这种编辑器场景Key 主要用在两类地方一是编辑器里调用的 AI 补全/格式化插件二是通过命令行工具做批量缩进修复时调用的接口。生成 Key 的入口在控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 进去之后找到 API Keys 页面新建一个 Key 并复制保存。注意 Key 只在创建时完整显示一次关掉页面就看不到了建议先存到本地密码管理器里。如果你只是想在编辑器里做缩进统一其实不一定需要联网调用模型纯 vim 配置就能搞定。但如果你想让 AI 帮你批量重排一个老项目的缩进风格或者做代码审查时的格式建议那就需要把 Key 配到对应的插件或 CLI 工具里。API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 这两个页面建议开着对照看。注意Key 属于敏感凭证不要直接硬编码到会提交到 Git 的配置文件里。建议用环境变量或者本地不纳入版本管理的文件来存放。3. 可复制的 settings.json 配置骨架很多人会问vim 不是用.vimrc吗怎么冒出个settings.json这里要区分两个层面。.vimrc是 vim 自身的配置管的是编辑器行为而settings.json通常是 VS Code、Cursor 这类编辑器里 vim 插件比如 VSCodeVim的配置文件或者是一些 AI 编码工具如 Claude Code 相关配置的落盘位置。两者配合使用.vimrc管纯 vim 环境settings.json管带 vim 键位的现代编辑器。先给纯 vim 的.vimrc骨架放在用户主目录下 ~/.vimrc set tabstop4 tab 显示为 4 个空格的宽度 set softtabstop4 编辑时按一次 tab 键插入 4 个空格 set shiftwidth4 自动缩进时每级 4 个空格 set expandtab 关键把 tab 展开成空格 set autoindent 新行继承上一行缩进 set smartindent 智能缩进适合 C 类语言 set list 显示不可见字符方便验证 set listcharstab:-,trail:·,extends: tab 显示为 ---行尾空格显示为 ·这里四个参数最容易混用表格对照一下参数作用常见误区tabstop(ts)tab 字符显示多宽只改显示不改落盘字符softtabstop(sts)编辑时按 tab 插入几个空格不设时跟随 tabstopshiftwidth(sw)自动缩进/的步长和 ts 不一致会导致缩进跳变expandtab(et)是否把 tab 转成空格不设这个前面全白搭再看settings.json骨架适用于 VS Code / Cursor 里装了 Vim 插件的场景{ vim.insertModeKeyBindings: [], vim.useSystemClipboard: true, editor.tabSize: 4, editor.insertSpaces: true, editor.detectIndentation: false, editor.renderWhitespace: all, [python]: { editor.tabSize: 4, editor.insertSpaces: true }, [makefile]: { editor.insertSpaces: false, editor.tabSize: 4 } }注意[makefile]那段Makefile 必须用真 tab所以这里insertSpaces要设成false这是唯一需要保留 tab 的场景。editor.detectIndentation设成false很重要否则编辑器会自作聪明地根据文件现有缩进覆盖你的设置导致同一个文件在不同机器上表现不一致。如果你要把 TaoToken 的 Key 接进某个 CLI 工具做批量格式化通常是在工具的环境变量或配置里填 API 地址和 Key比如export T AOTOKEN_API_BASEhttps://taotoken.net/api export TAOTOKEN_API_KEY你的Key上面变量名请按实际工具文档调整这里只是示意接入位置。接入文档里有各工具的详细字段说明照着填即可。4. 验证请求与成功结果配置写完不代表生效必须验证。第一步打开一个测试文件vim test_indent.py进入后按i进入插入模式敲一行代码然后按 tab 键缩进再敲一行。接着按Esc回到普通模式输入:set list回车后你会看到行首的缩进位置显示成---这样的符号取决于你的listchars设置。如果显示的是---而不是一个实心的 tab 符号说明 tab 已经被展开成空格了。再输入:set expandtab?如果返回expandtab说明开关是开的返回noexpandtab就是没生效回去检查.vimrc是否被正确加载。第二步验证落盘字符。保存文件后用cat -A看真实字符cat -A test_indent.py如果缩进位置显示的是空格cat -A下空格就是空格tab 会显示成^I说明 tab 真的转成了空格。如果看到^I那就是 tab 还在expandtab没起作用。第三步对已有文件做批量转换。假设你有一个老文件全是 tab想全部转成空格:set ts4 :set expandtab :%retab!%表示整个文件retab是重新制表!表示连非行首的 tab 也一起处理。不加!的话只处理行首缩进的 tab行中间的 tab 会保留。执行完再:set list看一眼确认全部变成空格。反过来如果某个 Makefile 被误转成了空格要转回 tab:set ts4 :set noexpandtab :%retab!这里noexpandtab是关键配合retab!把空格重新压成 tab。但要注意这种转换是有损的如果原来空格数不是 4 的整数倍转换后缩进会错位所以操作前最好先备份。5. 本篇常见错误排查错误一改了.vimrc但没生效。最常见的原因是文件路径不对。vim 启动时读的是~/.vimrc如果你写到了/etc/vimrc或者别的目录普通用户权限下不会加载。用:echo $MYVIMRC可以看当前实际加载的是哪个文件。另外如果系统里同时有vim和vivi可能指向的是精简版不读.vimrc建议直接用vim命令。错误二expandtab开了但粘贴代码时又变回 tab。这是粘贴时的自动缩进在捣乱。解决办法是在粘贴前执行:set paste粘贴完再:set nopaste。或者用:set pastetoggleF2绑定一个快捷键切换。错误三softtabstop和shiftwidth不一致导致缩进跳变。比如ts4但sw8按一次缩进跳 8 格看着很怪。建议这三个值保持一致Python 社区通常用 4也有用 2 的团队内统一即可。错误四detectIndentation覆盖了设置。在 VS Code 里如果这个选项是true打开一个用 2 空格缩进的文件编辑器会自动把tabSize改成 2你的 4 就失效了。设成false才能强制统一。错误五Makefile 被误转空格。这个最坑因为make报错信息不明显。记住 Makefile 里命令行前必须是真 tab配置里给[makefile]单独设insertSpaces: false。如果已经转错了用上面的:set noexpandtab:%retab!救回来。错误六Key 配了但请求 401。如果批量格式化工具报鉴权失败先检查 Key 是否复制完整、有没有多余空格再确认 API 地址是不是https://taotoken.net/api。控制台里可以重新生成 Key接入文档里有各语言的最小请求示例对照着调。6. 把缩进统一这件事落到日常缩进风格这种事单靠自觉很难统一最好落到配置和工具里。我的做法是项目根目录放一个.editorconfig把indent_style space、indent_size 4写死主流编辑器都认这个文件vim 这边用.vimrc兜底VS Code 用settings.json覆盖。三层配合基本不会跑偏。对于需要 AI 辅助做批量格式化的场景把 TaoToken 的 Key 配到对应 CLI 工具里用统一通道调用省得每个工具单独管凭证。模型对话入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 可以先用它验证一下格式化建议是否符合预期长期做编码和 Agent 任务的看 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite Claude Code 相关的接入说明在 https://taotoken.net/claudecode?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后留一个实用习惯每次接手老项目先:set list扫一眼缩进再决定要不要:%retab!。转换前git commit一次出问题能回滚。tab 和空格这点事配置对了就一劳永逸。