很多人用 VSCode 好几年装了一堆扩展插件等到要清理、换机器、或者排查某个插件引起的诡异问题比如 CPU 飙升、代码提示错乱、终端卡顿时才发现打开扩展面板一个个找“卸载”按钮真的累人——尤其是那种装了几十个上百个扩展甚至有些默认启用的又不开源又退不掉的扩展更是让人头疼。其实 VSCode 的命令行终端里早就内置了一套跟扩展插件相关的管理命令用法跟包管理器很像能列出、启用、禁用、卸载、批量处理扩展比用鼠标点 GUI 高效得多。这篇文章我不聊别的专门把“Vscode 终端命令彻底卸载扩展 Extensions”这个事讲透从命令原理、实际脚本、到中途踩过的坑和排查思路一次性给全。本文内容适合所有用 VSCode 的开发者不管你是刚入门的小白还是天天敲命令行的老鸟只要你想干净利落地接管自己编辑器里的插件这篇就能直接照抄作业。1. 内容整体设计与思路拆解1.1 为什么要在终端里操作扩展卸载先说个真实场景我之前在一台工作机上装 VSCode 加插件大概一百多个其中有一批是早期尝鲜安装的后来项目换技术栈基本用不上了。我当时想从插件面板里找到它们一个个卸载来回切了好几个视图还老是记不住到底哪些是用的、哪些是闲置的最后干脆开了个终端一条命令把所有扩展 ID 列出来再写个脚本批量干掉不用的一分钟全搞定。这就是终端命令最大的价值可批量、可脚本化、可远程、可审计。终端操作扩展还有一个好处就是它不依赖图形界面。很多时候你是在远程服务器上用 VSCode比如通过 SSH 连到开发机或者在 WSL 环境里跑图形面板虽然也能用但响应速度明显比命令行慢甚至会出现列表一直转圈、展示不全的问题。用命令直接管理扩展是纯 IO 操作逻辑清晰、输出稳定。1.2 核心思路code CLI 命令结构VSCode 安装完成之后会在系统里注册一个code命令Windows 上叫code.cmdmacOS/Linux 上一般叫code。这个命令本质上就是 VSCode 可执行程序的门面所有跟编辑器相关的操作都能通过它来做包括打开文件、比较文件、安装扩展、列出扩展。扩展相关命令最常用的几个是code --list-extensions列出所有已安装的扩展 IDcode --install-extension extension-id安装指定扩展code --uninstall-extension extension-id卸载指定扩展code --disable-extension extension-id禁用指定扩展不卸载code --enable-extension extension-id重新启用code --show-versions展示扩展的版本详情在动这些命令之前你得先确认code命令在终端里是可用的。这一步虽然基础但很多人真就卡在这。如果你在终端里敲code --version提示命令找不到根本原因一般是安装时没勾选“加到 PATH”或者 macOS 上装的是精简版没注册命令。解决办法很直接Windows 上重新运行安装包勾选“添加至 PATH”macOS 上打开命令面板输入Shell Command: Install code command in PATH执行完重开终端就生效了。这个命令模型本身是在“用户级”还是“系统级”操作的VSCode 的扩展分为用户扩展和工作区扩展命令行工具默认操作的是用户配置目录下的全局扩展列表。对于大部分开发者来说日常装的扩展都挂在用户级所以命令用起来很顺手无需额外指定。1.3 方案选型的原理解读如果你用过 npm、pip 或者 apt 这类包管理器再看code --install-extension这类命令会觉得特别亲切。VSCode 的扩展市场本质上也是一个远程仓库扩展 ID 都是publisher.name格式比如esbenp.prettier-vscode。命令行安装扩展时它内部会走扩展市场的协议下载对应插件包解压到用户目录下的.vscode/extensions文件夹里然后更新扩展列表缓存。卸载的过程则相反把插件目录删掉并从缓存列表里移除。所以你会发现一个现象有时候终端卸载报成功但插件面板里还残留显示重启 VSCode 之后才会消失。别慌下面第 4 章我会专门讲这个问题的排查思路。这里先把命令搞懂后面就顺了。2. 核心细节解析与实操要点2.1 查看当前已安装的扩展清单想卸载扩展第一步永远是“看清楚自己装了什么”。这里的推荐命令不是--list-extensions --show-versions直接用我建议先做一步分类code --list-extensions它输出的每一行是一个扩展的 ID比如ms-python.python esbenp.prettier-vscode github.copilot dbaeumer.vscode-eslint如果只输出 ID 不够你想附带知道每个扩展的版本和是否有更新可以加参数code --list-extensions --show-versions这个命令会输出类似ms-python.python2024.4.0 esbenp.prettier-vscode10.4.0 github.copilot1.5.2这种带版本号的信息在排查问题时很实用比如某个扩展最新版有兼容问题你想回退就先得知道当前装的是什么版本。你还可以在列表导出时顺手做一下数量统计Windows PowerShell 和 macOS/Linux 语法略不同但思路一样code --list-extensions | wc -l这个数字能让你对自己的“插件密度”有个直观认知。我用过的机器里有的开发机插件数超过 120 个其中真正每天都用得上的可能就 20 个左右其余全是历史遗留。这种情况下先在终端里跑一遍导出再把列表按“当前项目需要”和“可清理”两组分类比在 GUI 里挨个翻要高效得多。2.2 卸载单个扩展的准确姿势卸载单个扩展的命令语法非常简单code --uninstall-extension extension-id比如卸载 Python 扩展code --uninstall-extension ms-python.python执行完终端会输出一行提示不同版本略有差异Extension ms-python.python is uninstalled.如果你在卸载的时候忘了扩展的完整 ID只记得名字里带“python”可以先用--list-extensions配合 grep 过滤一下。macOS/Linuxcode --list-extensions | grep pythonWindows PowerShellcode --list-extensions | Select-String python这里有个细微但很关键的细节--uninstall-extension后面的扩展 ID 必须严格匹配列表里的 ID大小写、点号都不能错否则终端会报错或者找不到目标。如果你想把卸载过程显式化可以先执行--list-extensions把输出丢到一个文本文件里然后从文件里精确复制你要卸载的 ID。这样能避免手滑敲错。注意如果当前 VSCode 正在运行且你要卸载的扩展正在被使用比如正在用某个语言服务扩展编辑文件终端里卸载基本能完成但建议还是先保存好未保存的文件再操作以免扩展崩溃导致内容丢失。我在实测中遇到过几次卸载正在使用的扩展后编辑器里某个语言服务报了错误重启编辑器才好。2.3 命令行禁用和启用扩展比卸载更灵活的方案有些扩展不是你完全不用而是“暂时不用”或者“疑似有问题需要隔离验证”。这时候不要急着卸载用禁用更稳。禁用扩展不会删除文件只是在启动时不让它加载遇到问题想再恢复很容易。禁用单个扩展code --disable-extension extension-id而且 VSCode 还支持直接禁用所有扩展进入“干净模式”排查问题时特别常用code --disable-extensions这个命令会启动一个新的编辑器窗口所有扩展都不加载。如果你发现这个窗口里编辑器不再卡顿、报错消失那基本可以断定问题是某个扩展引起的。再恢复启用单个扩展code --enable-extension extension-id这个模式最大的价值在于它让你能够二分法排查禁用所有扩展如果问题消失再分批次启用扩展、逐个隔离问题源。这个思路我们在第 4 章还会再展开。2.4 卸载之前必须注意的扩展关联问题VSCode 的扩展不像独立软件那样跟系统有千丝万缕的依赖但它会涉及几个隐蔽关联点清理前你得心里有数工作区级配置引用如果你在.vscode/settings.json或settings.json里写了某个扩展的配置项比如editor.defaultFormatter: esbenp.prettier-vscode卸载扩展后这个配置项就会变成无效键。VSCode 在打开工作区时会提示“未知配置项”虽然不影响开发但从此打开项目就多了一道“警告横幅”看着很碍眼。键盘快捷键有些快捷键绑定是扩展提供的比如 Python 扩展的jupyter相关组合键卸载后快捷键会消失如果你的肌肉记忆还按原来的组合键会发现没响应这时候需要在快捷键面板检查哪些绑定键是未定义状态。代码片段Snippets如果你使用过某些扩展提供的代码片段卸载之后这些片段就不再可用但你自己定义的 snippet 文件保留在用户目录不受影响。共享语言服务有些扩展之间互相依赖比如你卸载了某个 LSP 客户端扩展但另一个扩展还依赖于它启动的语言服务器结果就是另一个扩展的某些功能失效但不报错。所以我的建议是卸载之前先搜一下当前项目根目录下的.vscode/settings.json以及用户级settings.json凡是涉及你准备卸载的扩展的配置项提前清理或改掉。不然卸载完VSCode 会一直给你提示“Dont show again”的选项你要是眼不见为净点了忽略后面排查问题又会少一条线索。3. 实操过程与核心环节实现3.1 单条命令完成“查找和删除命令”全过程现在进入实战。假设我要卸载一个叫old-theme-extension的插件但我记不清完整 ID 了。完整流程如下第一步打开终端Windows 下可以用 PowerShell 或 CMDmacOS 用 Terminal 或 iTerm2确认code命令可用code --version输出类似1.85.0 ...第二步列出所有扩展并过滤出关键词code --list-extensions | grep old-theme如果输出mytheme.old-theme-extension第三步精确卸载code --uninstall-extension mytheme.old-theme-extension输出Extension mytheme.old-theme-extension is uninstalled.第四步重新列一次确认卸载干净code --list-extensions | grep mytheme无输出说明列表中已不存在该扩展。整个过程不超过 20 秒。如果你是在远程开发机上操作用 SSH 终端执行完全一样的命令也是可行的VSCode 的命令行扩展管理接口在不同环境下表现一致这一点在团队协作、统一开发机环境时特别管用。3.2 批量导出、批量卸载的脚本方案单条卸载适合点对点清理但如果你像我之前那样需要一次清掉二三十个不用的扩展一个个敲命令就有点傻了。下面这个思路你可以参考。首先把当前完整的扩展列表导出到文件code --list-extensions installed-extensions.txt然后用文本编辑器打开这个文件把你想保留的扩展留下其他行删除另存为keep.txt。接着在终端里用循环语句对比两个列表把不在保留列表里的扩展全部卸载。macOS/Linux 下用 Bashwhile read ext; do if ! grep -q ^${ext}$ keep.txt; then code --uninstall-extension $ext fi done installed-extensions.txtWindows PowerShell 下则这样写$extensions Get-Content installed-extensions.txt $keep Get-Content keep.txt foreach ($ext in $extensions) { if ($keep -notcontains $ext) { code --uninstall-extension $ext } }这段脚本的思路很简单全量列表减去保留列表剩下的就是待清理列表。执行之后终端会逐条打印卸载结果你就能看到哪些成功了。如果某条报错“Extension is not installed”大概率是扩展 ID 里带了空格或者不可见字符检查一下文件编码和换行符就好。批量安装也是一样的套路把扩展 ID 一行一个放进文件然后while read ext; do code --install-extension $ext done extensions-list.txt这个方式在换新电脑时尤其有用先在新机器上导出旧机器的扩展清单再批量安装基本能无缝恢复你的开发环境。我自己的做法是把常用扩展清单按项目类型维护成多个文件比如web-dev.txt、python-dev.txt、deeplearning.txt需要哪个环境就批量装哪个插件治理非常清晰。3.3 用扩展 ID 精确清理 VSIX 安装的扩展还有一种情况是扩展不是从市场装的而是通过.vsix文件离线安装的比如公司内网环境、或者一个尚未公开发布的内部插件。这类扩展用code --list-extensions也能看到卸载方式跟市场扩展完全一样仍然用扩展 ID 卸载。比如code --uninstall-extension company.internal-tool如果你压根不知道它的 ID 是什么可以到用户扩展目录里看一下具体文件夹名文件夹的命名格式通常是publisher.extension-name-version其中publisher.extension-name就是扩展 ID。macOS 上扩展目录一般是~/.vscode/extensions/Windows 上一般是%USERPROFILE%\.vscode\extensions\Linux 上对应~/.vscode/extensions/直接删目录确实也能达到“卸载”的效果但我不推荐手动删因为扩展目录里还可能包含.obsolete等标记文件手动删不干净的话VSCode 启动时会尝试根据记录重新加载导致各种玄学问题。用code --uninstall-extension会同步处理这些状态干净又安全。3.4 验证清理成果与配置残留检查卸载完一波扩展后别急着关终端推荐按下面三步确认清理效果第一步确认扩展列表里已经没那些 IDcode --list-extensions第二步检查扩展目录中的实际残留macOS/Linuxls ~/.vscode/extensions/ | grep 关键词Windows PowerShellGet-ChildItem $env:USERPROFILE\.vscode\extensions | Where-Object { $_.Name -match 关键词 }如果输出为空基本说明目录层也已清理干净。如果有残留目录多半是卸载过程不正常比如 VSCode 还在运行、文件被占用需要关闭所有相关进程后手动删除。第三步打开 VSCode 设置面板快捷键Ctrl,/Cmd,在搜索框里搜卸载掉的扩展名看是否还有残留配置项。如果有手动删掉对应键值。这里尤其要注意.vscode/settings.json和settings.json里的配置。你不删编辑器也能运行但会在“设置”副标题里一直给你标黄提示很影响观感。4. 常见问题与排查技巧实录4.1 命令提示“command not found”或“不是内部或外部命令”这是新手最容易卡住的一步。如果终端提示找不到code命令一般有三种原因一是安装时没加入 PATH二是 shell 缓存没刷新三是用的安装版本没有命令行工具。解决办法按优先顺序Windows重新运行 VSCode 安装包在选择组件的步骤中勾选“添加到 PATH”选项完成后重启终端。macOS打开 VSCode 命令面板CmdShiftP输入Shell Command: Install code command in PATH并执行之后重开终端。Linux确认安装包是否来自官网仓库如果用了 Snap 版的 VSCode有时code命令会被封装成code的路径问题可以用/snap/bin/code或者重启整个终端环境解决。所有平台试着重开终端。如果 zsh 或者 bash 的hash缓存里没有更新确实会偶发找不到命令的情况。我给个小技巧你在终端里可以先执行which codeWindows 用where code如果输出一个路径说明命令本身就存在问题可能是 PATH 顺序或者 shell 缓存如果没有任何输出那就按上面三种原因逐个排查。4.2 卸载后扩展还出现在列表里怎么办我在实际使用中遇到过这种现象跑完code --uninstall-extension命令也提示成功但再次执行code --list-extensions这个扩展还在列表里。折腾过几次之后我总结出来的原因主要是这两类第一VSCode 处于运行状态。命令行工具在修改扩展列表时如果编辑器进程正在运行可能会因为文件占用或者缓存机制导致删除不彻底。解决办法是关掉所有 VSCode 窗口后再重新执行卸载命令。第二扩展同时存在于多个层级。VSCode 支持用户级、工作区级和内置扩展其中内置扩展无法卸载比如vscode.typescript-language-features这类工作区级扩展配置在某些场景下也会重新拉取依赖。你用命令行卸载的是用户级条目但工作区里通过.vscode/extensions.json推荐的扩展可能会在重启后重新提示安装。如果确认不是上面两种情况还有最后的大招直接去扩展目录删文件夹同时清理~/.vscode/extensions/.obsolete文件里对应的行。操作前记得关掉 VSCode。删完再启动编辑器去看扩展面板还显不显示。其实严格来说不属于内置扩展的情况下用命令行卸载之后那个扩展还出现在列表里多数情况是编辑器没重启界面缓存没更新。重新加载窗口开发人员工具里有 reload window往往就能解决。4.3 批量脚本执行到一半卡住如何继续跑完批量卸载跑循环时偶尔会遇到某一条命令在下载或解析插件信息时卡住。尤其是扩展数量多、网络状况一般的情况下终端会等一段时间才输出结果。遇到这种别直接CtrlC全停更稳妥的做法是给命令加超时逻辑比如 macOS/Linux 用timeout 30 code --uninstall-extension $ext需要安装了 coreutils超时会自动跳过这一条。或者先暂停整个脚本手动执行这一条出问题的卸载确认它到底是在等网络还是在等锁。然后用记录文件标记成功和失败的分界点跳过已成功的继续跑。我用 PowerShell 批量处理时习惯在脚本里加个“继续执行不中断”的-ErrorAction Continue逻辑具体写法按你的 PowerShell 版本微调这样即使个别扩展卸载报错也不会中断整批清理。重点不是一次性全成功而是最后能看到一份“哪些成功、哪些失败”的清单针对失败的再人工处理效率和成功率反而更高。4.4 卸载某些扩展后编辑器功能异常怎么恢复卸载完后发现某个功能没了这种情况在开发环境中太常见了。比如我卸载了某个“花里胡哨”的主题扩展结果发现代码高亮风格变了——这是正常的因为高亮回退到了默认配色。但如果你发现的是更实质性的问题比如格式化代码不起效、代码跳转失灵、调试器按钮灰掉那就需要仔细排查了。排查思路很简单先在终端执行code --list-extensions确认你是不是真的把某个功能依赖的扩展卸了。比如你把 ESLint 卸了代码里那些红色的校验波浪线自然就没了这不是 VSCode 出 bug是你把校验器干掉了。回忆一下自己刚卸了哪些扩展挨个查一下有没有替代方案。有些扩展卸载后它的某些能力会被内置功能接管但不会完全一致。比如卸载了某个括号高亮扩展编辑器还是会显示基础括号匹配只是没之前那么炫。要是实在找不回当时的功能就重新把扩展装回来。批量安装非常快一条code --install-extension就搞定安装完重载窗口即可。这里我还想多说一句卸载扩展之所以容易“误伤”功能核心原因是很多扩展之间是存在传递依赖的。比如你装了某个框架的语言服务器扩展它内部可能自动帮你装了另一个格式化扩展但你只卸载了表面那个格式化扩展可能还停在那里。所以不要只盯着自己要卸载的那一个多看一下 VSCode 的输出面板中的扩展日志了解清楚依赖关系再动手。4.5 实测整理的扩展命令速查表下面这张表是我在使用过程中整理的直接保存在笔记里每次批量清理扩展前都会扫一眼命令作用常用场景code --list-extensions列出所有扩展 ID查看当前扩展全貌、导出清单code --list-extensions --show-versions列出扩展 ID 加版本排查版本兼容问题code --install-extension id安装指定扩展按清单批量恢复环境code --uninstall-extension id卸载指定扩展清理无用插件code --disable-extension id禁用指定扩展隔离污染源、临时关闭插件code --enable-extension id启用指定扩展恢复被禁用的插件code --disable-extensions启动时禁用所有扩展快速定位问题是否由扩展引起code --install-extension vsix路径离线安装 vsix 包内网环境、私有插件安装code --status查看进程状态信息确认编辑器是否真在运行这个速查表其实已经把 VSCode 扩展管理 90% 的日常需求覆盖了。剩下那 10% 是 GUI 上的一些特殊管理功能比如更新、降级、按来源筛选但说实话在终端里通过切换扩展 ID 的方式完全能做到同样的效果只是命令步骤多一点。5. 实战案例一次完整的扩展清理与一键恢复5.1 先用命令给编辑器来一次“全量体检”上个月我想给公司一台老开发机“瘦身”那台机器从三年前开始用 VSCode中间换过几轮项目方向从 Node.js 写到 Java 后端又写过一段物联网的嵌入式代码后来还尝试过一阵 Python 数据分析。插件越积越多最直观的表现是打开编辑器要 10 秒以上操作偶尔觉得画面掉帧。我当时心里清楚大概率是某些常驻扩展拖累了性能。于是我先在终端里导出了问题源的候选名单code --list-extensions --show-versions all-ext.txt看到输出的 87 个扩展我心里大概有了数。紧接着我用下面的命令看每个扩展的占用情况这一步需要在编辑器内部配合否则只看命令导出结果很难判断谁占资源多打开 VSCode 的“开发者进程面板”快捷键CtrlShiftU可以看到输出进程管理在命令行面板→Developer: Show Running Extensions这个面板会列出每个扩展的激活时间和占用的进程 ID是定位性能问题最直接的证据。结合这份数据和项目实际需求我整理出了 30 多个不再使用的扩展记录在一个清理清单里。5.2 批量卸载加验证一次搞定按上面第 3.2 节的脚本思路我把待清理清单存进文件然后跑循环卸载。中途有几条因为网络原因卡了几秒但都顺利执行完。卸载结束后我再次执行code --list-extensions列表从 87 个降到了 52 个。随后我检查了一下扩展目录确认没有多余残留ls ~/.vscode/extensions/ | wc -l数量上比扩展列表多几个是因为有少量扩展在目录里留下了一些配置文件但属于正常现象比如代码片段和全局 storage。我重启了编辑器启动速度确实快了不少。5.3 另一台机器秒级恢复环境那台机器清理完之后我顺手把保留的扩展列表导出到仓库里维护code --list-extensions ./extensions/essential.txt后来入职了一个新同事我直接把这份清单发给他他在自己机器上执行while read ext; do code --install-extension $ext done essential.txt十分钟不到他本地的 VSCode 就跟团队环境基本对齐了。这也是命令行管理扩展最好的一个附带收益环境标准化、可复制、可审计。比起让每个人按照 PPT 截图里的插件名搜了装、装了配效率提升不是一个量级。6. 个人实操体会与一个补充小技巧我自己的习惯是每两个月左右跑一次扩展清单对照最近的工作内容删掉不用的扩展。这个事靠 GUI 手动做确实比较烦但用code命令以后基本零负担导个清单写个循环再验证一下全程不超过五分钟。VSCode 的扩展管理命令其实远比大多数人以为的要成熟--list-extensions、--install-extension、--uninstall-extension这几个核心命令已经能覆盖日常百分之九十的插件管理需求剩下的部分靠组合脚本和速查表也能轻松补齐。最后再分享一个小技巧如果你要在一台新电脑上完整复刻旧机器的扩展环境除了导出扩展 ID 清单我还建议你把用户级别的settings.json和keybindings.json也一起备份起来。扩展只是工具的一部分真正的个性化配置才是你回不去旧手感的原因。把这些文件存进自己的配置仓库配合code命令的批量安装换机器、重装系统、加入新团队都能做到“无缝搬家”。这套流程我现在已经跑通很多次了实测非常稳。