code --install-extension 命令不生效的主因是 cli 未注册到 path，需通过 shell command: install 'code' command in path 手动添加；安装 .vsix 必须用完整路径并处理空格与权限；插件安装后必须手动重载窗口才能启用，且可能被工作区禁用。
code --install-extension 命令不生效？先确认 CLI 是否就位
命令行安装失败，八成不是插件问题，而是 code 命令根本没被系统识别。VS Code 安装时默认不自动加入 PATH，尤其在 Linux 或 macOS 上用 .zip 解压安装、或 Windows 用 User Installer 但没勾选“添加到 PATH”时，code 就不存在。
执行 which code（macOS/Linux）或 where code（Windows）验证。如果无输出，需手动注册 CLI：
- 打开 VS Code，按
Ctrl+Shift+P输入Shell Command: Install 'code' command in PATH并回车 - Linux/macOS 用户若用 Conda 环境，可能还需
source ~/.bashrc或source ~/.zshrc刷新环境 - 验证：运行
code --version能正常打印版本号才算成功
安装 .vsix 文件时路径和权限怎么处理
用 code --install-extension 安装本地 .vsix 文件，必须提供**完整路径或当前目录下的准确文件名**，不能只写插件 ID。
常见错误包括：
- 文件名拼错，比如漏掉
.vsix后缀（Microsoft.VisualStudio.Services.VSIXPackage≠Microsoft.VisualStudio.Services.VSIXPackage.vsix） - 路径含空格或中文，未加引号（正确：
code --install-extension "./my plugin.vsix"） - 权限不足：Linux/macOS 下若提示
Permission denied，先运行chmod 644 your-extension.vsix
装完插件却不启用？重启窗口是硬性要求
code --install-extension 只负责把插件文件复制到扩展目录，**不会自动激活它**。已打开的 VS Code 窗口完全感知不到新插件，图标灰色、功能不可用都是正常现象。
必须主动触发重载：
- 快捷键：
Ctrl+Shift+P→ 输入Developer: Reload Window→ 回车 - 或者彻底关闭所有 VS Code 窗口，再重新启动
- 注意：右下角弹出的 “Restart to enable” 提示点“重启”有时无效，务必手动执行上述操作
插件装上了但找不到？检查是否被工作区禁用
即使插件状态显示“已安装”，也可能被当前工作区单独禁用——这比全局禁用更隐蔽，界面几乎不提示。
排查方法：
- 左下角齿轮图标 →
Extensions→ 找到目标插件 → 看右上角按钮文字是Disable (Workspace)还是Disable (Global) - 如果是前者，点击它切换为启用；也可在设置里搜
extensions.ignoreRecommendations关闭推荐干扰 - 语言类插件（如
ms-python.python）尤其容易因工作区配置被压制，建议打开任意.py文件后右下角语言模式确认是否生效
真正麻烦的不是命令本身，而是 VS Code 的状态管理机制——它把“安装”“启用”“作用域”三件事拆得特别开，稍不注意就卡在某一层。每次装完都手动 reload 一次，比猜哪里错了省时间得多。
