VSCode插件安装与管理唯一推荐入口是内置Extensions视图，快捷键Ctrl+Shift+X（Win/Linux）或Cmd+Shift+X（macOS），所有操作须在此界面完成；手动复制文件夹、拖拽安装包或修改extensions目录路径均不可靠，易致插件不加载、无法更新或卸载残留。
Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）打开扩展视图，是安装和管理插件的唯一推荐入口——所有操作都应在该界面内完成，手动复制文件夹、拖拽安装包或修改 extensions/ 目录路径均不可靠，大概率导致插件不加载、无法更新或卸载后残留。
搜不到插件？先确认网络与市场状态
搜索框为空或返回“no extensions found”，不是插件下架了，而是 VS Code 没连上 Marketplace。常见原因包括：
-
extensions.autoCheckUpdates或extensions.autoUpdate被设为false，导致根本不尝试联网拉取列表 - 国内直连超时，但 VS Code 不支持换源，只能临时绕过：在
settings.json中添加代理配置，例如"http.proxy": "http://127.0.0.1:7890"（按你本地代理端口调整） - 误切到
@installed或@disabled标签页，导致新插件搜不出来——记得点回第一个默认标签页
安装后不生效？重点看重启与激活条件
很多插件不是“装完就用”，是否启用取决于触发条件：
- 语言类插件（如
ms-python.python）需打开.py文件才会激活；纯 UI 类（如GitLens）通常立即可用 - 格式化类插件（如
esbenp.prettier-vscode）需配合editor.formatOnSave等设置才起作用，单独安装不会自动开启 - 部分插件（如
Remote - SSH）明确要求重启窗口，右下角会有提示，忽略后功能静默失效 - 安装后执行
Developer: Reload Window是最稳妥的验证方式，比单纯重开编辑器更彻底
卸载插件后还有副作用？必须手动清理三处残留
点击 Uninstall 只删代码，不碰配置——这些残留常引发后续冲突：
-
settings.json里仍存着插件专属字段，例如卸载bracket-pair-colorizer后，"bracketPairColorizer.disabledLanguages"还在，可能干扰新配色方案 -
keybindings.json中绑定的快捷键（如extension.prettier.format）不会自动删除，下次装同名插件可能报错重复注册 - 工作区级推荐文件
.vscode/extensions.json里的"recommendations"条目需手动删掉，否则协作者一打开项目就弹安装提示
命令行装插件失败？检查 CLI 路径与热加载限制
code --install-extension 在 CI、Docker 或批量部署中很实用，但容易卡在两个环节：
- 运行
which code（macOS/Linux）或where code（Windows）确认输出的是当前 VS Code 安装路径；若提示command not found，需先在 VS Code 命令面板中运行Shell Command: Install 'code' command in PATH - 已打开的 VS Code 窗口不会自动加载新装插件，必须执行
Developer: Reload Window或完全退出重进 - 批量安装建议加
--force参数，避免交互式确认中断脚本，例如：code --install-extension esbenp.prettier-vscode --force
真正麻烦的从来不是“怎么装”，而是“装完谁在管”。插件的启用状态、配置归属层级（用户 / 工作区 / 远程）、以及它悄悄改过的全局设置，这三者叠加起来，才是多数人排查半天才发现不了的问题根源。
