2.1 补全与代码片段：给双手省力

2.1 补全与代码片段：给双手省力

本节摘要：智能补全负责"少打字"，代码片段负责"不重复打字"。本节先配好编辑器的补全触发策略与片段建议排序，再上架值得信任的补全增强器与片段包，最后手写一个带占位符的自定义片段。输入端的这件电动工具调校得当，日常击键量能明显下降。

敲代码这件事，说到底是手指在键盘上搬砖。搬得快慢倒在其次，更要命的是重复：同一个日志语句一天敲几十遍，同一个组件骨架一个项目里写几十份。工位升级的第一件装备就该装在这里——补全管"打到一半有人递词"，片段管"整段模板一键铺开"。上一章办完了装备手续，从这一节起正式开工位。

什么时候需要这件装备

先划边界，免得重复采购。裸装的 VS Code 已经有基础补全：任何语言都有基于当前文件的词级补全，装了语言扩展的语种还有完整的语言服务补全（补函数、补参数、补类型）。什么信号说明该升级输入装备了？三个信号：补全列表里常出现"完全不相关"的候选，说明词级补全在制造噪声；经常整段复制旧代码再逐处改名，说明缺片段；写着写着要去别处翻文档抄接口签名，说明补全的信息量不够用。对号入座了，再往下装。

安装与配置：先把底座调好

补全装备的底座不是插件，而是编辑器自带的几项策略。先调底座，再上插件，顺序不能反：

{
  "editor.quickSuggestions": {
    "other": true,
    "comments": false,
    "strings": false
  },
  "editor.suggestOnTriggerCharacters": true,
  "editor.snippetSuggestions": "top",
  "editor.suggestSelection": "first",
  "editor.acceptSuggestionOnEnter": "on",
  "editor.tabCompletion": "onlySnippets"
}
​

逐项说人话：快速建议控制在"正文开、注释关、字符串关"——注释和字符串里的自动弹窗大多是打扰；触发字符建议保持开启，点号、冒号后立刻出候选是语言服务的主场；片段建议置顶，让模板排在普通候选前面，一眼能挑出来；Tab 键补全限定为"仅片段"，避免 Tab 和接受建议打架，这是补全体验里最常见的键位冲突点。

底座调完，再按需上插件。补全增强器里，官方出品的智能排序器（根据上下文把常用候选前置）值得默认装上，它只是给现有候选重新排座次，轻且无侵入；第三方的本地补全引擎适合在离线环境或老机器上当"低配语言服务"用；云端补全助手（生成式的那种）属于另一档装备，涉及代码外发策略，由团队统一决定，本节不展开。

片段包按语种上架：写前端装对应框架的组件片段包，写 Python 装函数与测试模板包。片段包是纯数据装备，性能档位最轻，试错成本低，不合适换掉就是。

图 2-1：一次补全建议的诞生与呈现

台面实测：从敲到收的三段体验

实测一段最日常的操作。写一个模块导入语句：敲下导入关键字，语言服务的路径补全立刻列出项目里的文件，配合路径感知类插件还能提示包名；接着调一个函数，参数提示直接浮出来，不用翻定义；最后补一条日志，敲出片段触发词，整行语句连括号一起落地。三段下来，键程明显缩短。

再实测片段的真实工效。以一个前端组件骨架为例：装好框架片段包后，敲组件的触发词、按回车，整套骨架（导入、组件定义、导出）一次铺开，光标自动落在组件名占位位上；改完名字按 Tab，光标跳到内容占位位继续写。原来四十几秒的样板活，压到十秒上下——省下的不是时间，是"抄旧文件再漏改一处"的隐患。

坑点提醒

这装备的坑集中在三处。坑一，补全候选太杂：词级补全把全项目打开过的词都塞进列表，可以在语言服务补全到位的语种里关掉词级来源，列表立刻干净。坑二，Tab 键双重身份：默认配置下 Tab 既接受建议又缩进还跳片段占位符，三职打架；用上面的"仅片段"配置把 Tab 的职责收窄。坑三，片段包冲突：装了多个片段包后，同一个触发词可能对应好几个模板，弹层里要靠描述区分；对策是只留一套主力片段包，其余卸载，缺口用自定义片段补。

替代方案

不想装任何补全插件的极简路线：只靠语言服务补全加内置片段，把触发策略调紧一点，日常也够用，代价是候选排序欠聪明、模板覆盖靠自建。重度路线是上云端补全助手，效率增益大但涉及代码出域与费用，属于团队级决策。我的建议是先走"语言服务 + 官方排序器 + 一套片段包"的中间线，跑顺了再谈加码。

常见疑问快答

问：补全弹窗把代码挡住了怎么办？答：这多半是触发策略过宽——字符串与注释里也在弹。回到底座配置，把快速建议的这两路关掉，只在正文里弹；再配合预览窗的手动展开快捷键，需要详情时再看。弹窗的哲学是“召之即来挥之即去”，常驻挡视线就是配置失败。

问：片段和模板文件（项目脚手架）有什么区别？答：片段管“行级与块级”的重复——函数骨架、日志语句、组件外壳；脚手架管“项目级”的初始化——目录结构、构建配置。两者的粒度差了两个数量级，混用任何一方去干另一方的活都是受罪。中间地带（如多文件组件生成）留给专门的生成器装备。

问：装了片段包之后，怎么快速摸清它提供哪些触发词？答：两条路：一是看装备详情页的说明文档，成熟的片段包都会列触发词表；二是实战摸索——在空文件里敲你想要的动作缩写，看弹出的片段候选及其描述，命中就记进自己的速查表。两周下来，常用的那十几个触发词会自然沉淀。

问：团队之间怎么共享自定义片段？答：项目级片段放进工作区的片段目录、随仓库分发，是最顺的通路；用户级片段各人自留。共享的片段文件同样走评审，触发词命名先约定前缀，避免与片段包的触发词撞车。

问：补全用多了会不会“离了它不会写代码”？答：会有这种依赖，但性质不坏——你记住的应该是“结构与方法”，让肌肉去记“拼写与样板”。真要防的是“补全错了也照单全收”：养成扫一眼候选再接受的余光习惯，依赖就停留在健康区间。

收束与下一站

这一节把输入端的省力装备调校到位：底座策略、片段包、占位符语法都过了手。输入省下来的力气，下一节花在输出上——格式化与风格检查这对定规组合，解决"代码写完长什么样、对不对"的问题。