1.3 上装备：安装、管理与退役

1.3 上装备：安装、管理与退役

本节摘要：插件的完整生命周期包括安装、启用、禁用、卸载与配置清理。本节覆盖界面安装与命令行批量安装、离线装配通路、工作区级启停、禁用与卸载的取舍，以及用扩展推荐文件把装备清单固化成团队工位图纸的方法。装备手续办得干净，工位才不会越用越堵。

某天下午你接手同事的机器，打开他的 VS Code，扩展面板密密麻麻装了一大排，其中不少连他自己都想不起装来干什么——这就是典型的"只上不下"工位病。装备管理的要义和木工房一样：上新件要有手续，旧件要能退役，全部家当要有一张清单。本节承接前两节的"认底盘、逛货架"，把采买回来的装备正式办入位手续，也是第 1 章的收尾。

装备的生命周期：一图看全

一件插件从进入工位到离开，要走过几个状态。心里有这张状态图，后面的每个操作都知道自己处在哪一环：

图 1-3：插件装备生命周期状态图

安装的几条通路

界面安装是日常通路：扩展面板搜名、点装、必要时重载窗口。命令行安装是批量通路，把装备编号（形如"发布者.名称"的扩展标识）交给命令行工具：

code --install-extension ms-python.python
code --install-extension esbenp.prettier-vscode
code --list-extensions --show-versions
​

第三条命令列出全机已装装备与版本，配合重定向就能导出装备清单。给新机器整备工位时，把清单文件逐行喂给安装命令，几分钟恢复全套家当。更省事的做法是用内置的配置同步功能，登录账号后设置、快捷键、扩展连同状态一起走账号漫游——这一功能早年也靠第三方插件实现，后来被收编进出厂清单，是"装备史"上著名的收编案例。

离线装配是特殊通路。有些机器内外网隔离，装不了市场：先在一台能上网的机器上下载插件的离线包（后缀为 vsix 的安装文件），拷贝过去后走命令行装配：

code --install-extension .\prettier-vscode-11.0.0.vsix
​

离线装配的装备不会自动更新，升级时需重复下载新版离线包，这条限制在采买时就要记入台账。

禁用与卸载：退役的两档

装备出问题时的第一反应应该是禁用而不是卸载。禁用分全局与工作区两档：怀疑某插件引发卡顿时，先在工作区档禁用它做对照实验——问题消失，说明装备与此工作区犯冲；问题仍在，再考虑全局禁用或继续排查。禁用的装备仍然驻留在机器里，配置原样保留，随时可以重新启用，适合"暂时下岗"的装备。

卸载则是清场。但要注意一个细节：卸载插件不必然清理它的配置项。那些以插件标识为前缀的设置键会留在设置文件里，成为"装备坟场"。彻底退役的规范动作是卸载后再打开设置文件，把对应前缀的键逐一清走；装备若在工作区推荐清单里挂了名，也一并移除。第 6 章治理配置项时，这些残留正是排查噪声的来源之一。

把装备清单固化成工位图纸

单人工位靠记忆，团队工位靠图纸。工作区里可以放一份扩展推荐文件，成员打开项目时，编辑器会提示安装推荐装备：

{
  "recommendations": [
    "ms-python.python",
    "ms-python.vscode-pylance",
    "charliermarsh.ruff",
    "ms-python.black-formatter"
  ],
  "unwantedRecommendations": [
    "ms-python.pylint"
  ]
}
​

推荐清单写"这个项目该装什么"，反向清单写"这个项目别装什么"——后者常被忽略，却是防止旧装备在新项目里捣乱的关键。比如项目已迁移到新一代代码检查器，把老检查器的集成插件列入反向清单，新人打开项目就会收到明确提示。这份图纸和第 6 章的工作区设置放在一起，就构成了团队工位的"移交档案"。

一个完整的退役案例

走一遍全流程。团队某项目早年用老牌括号着色插件，后来该功能被编辑器内置，插件成了纯负担：打开扩展面板找到它，先全局禁用一周，确认没有任何工作流依赖它（这一步防止"以为没用其实有用"的误伤）；然后把设置文件里它的前缀配置键删净；再从各项目的推荐清单里移除；最后卸载。至此，这件装备从"运行"到"痕迹"全部清场，工位账面干干净净。

常见疑问快答

问：禁用和卸载，到底先走哪一步？答：怀疑装备引发问题时先禁用——它可逆、可对照、保留配置；确认长期不用了再卸载，并顺手清掉设置残留。把卸载当第一反应的人，往往会因为“配置还在但装备没了”的半退役状态困惑很久。

问：装备更新失败或装不上，先查什么？答：先确认网络与市场连通；再核对版本兼容——编辑器太旧时新装备可能拒绝安装；最后看装备的发布页有没有已知安装问题的公告。内网环境则检查离线包版本与编辑器版本是否匹配。

问：换新机器时，装备怎么迁移最省事？答：账号同步是首选通路，登录即恢复；不愿走账号的，用导出清单加批量安装命令的组合拳——清单来自列出已装装备的命令，安装循环逐行喂给安装命令。两条通路都要求“工作区推荐清单”随仓库先行，项目级装备不靠个人迁移。

问：扩展推荐文件该推荐到多细？答：推荐到“该项目开工必需”的粒度即可，不必把个人偏好塞进去。判断口诀：没有它项目跑不起来的，进推荐；装了它才顺手的，留在个人清单。反向推荐则专收“已知会捣乱”的旧装备，宁缺毋滥，每条都该有理由注释。

问：装备的“配置残留”具体指什么，危害有多大？答：卸载插件后，以它标识为前缀的设置键仍留在设置文件里——轻则是新人读配置时的困惑源，重则是下次安装同名装备时“复活”了旧值、触发难查的行为异常。退役手续里“清配置”一步，就是防这个。

问：装备装完要不要重启编辑器？答：多数现代装备支持热装载，装完即用；涉及深度界面改动或声明了需要重载的，编辑器会明确提示。拿不准时的通用做法：重载一次窗口，成本几秒，换来确定性的生效状态。

收束

第 1 章到此闭环：认了底盘、学了逛货架、办完手续。从下一章起进入真正的升级轮次——先上的是不分语种、人人要用的基础效率装备：补全、格式化、导航、调试、版本控制。