code命令在终端中不可用，是因为VS Code默认未将自身路径写入系统PATH：Windows安装时未勾选“Add to PATH”，macOS/Linux手动解压安装或Snap版均不自动注册，需通过命令面板执行“Shell Command: Install 'code' command in PATH”或重装修复。
能直接用 code --install-extension 安装，但前提是 code 命令必须在终端里可用，否则会报 command not found。
为什么 code 命令在终端里找不到
VS Code 默认不把自身路径写入系统 PATH，尤其在 Linux 或 macOS 上手动安装（非商店/包管理器安装）时更常见。Windows 用户如果没勾选“Add to PATH”安装选项，也会遇到同样问题。
- 运行
code --version报错，基本可确认命令未注册 - GUI 启动的 VS Code 和终端里的
code是两套路径逻辑，不能互相替代 - Conda 环境下尤其容易失效，因为 shell 初始化脚本（如
~/.bashrc）可能没被 source 过
让 code 命令生效的实操步骤
先确认 VS Code 可执行文件位置，再把它加进环境变量：
- macOS：通常在
/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code，执行sudo ln -s /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code /usr/local/bin/code - Linux：若通过
.tar.gz解压安装，code就在解压目录下的bin/code，用export PATH="/path/to/vscode/bin:$PATH"临时生效，或写入~/.bashrc - Windows：重装 VS Code 时勾选 “Add to PATH”，或手动把
C:\Users\<user>\AppData\Local\Programs\Microsoft VS Code\bin</user>加入系统环境变量
改完后新开终端，再跑 code --version 验证是否成功。
--install-extension 的实际用法和常见陷阱
这个命令支持两种参数形式：插件 ID（在线拉取）和本地 .vsix 文件路径（离线安装），行为完全不同：
- 在线安装：
code --install-extension ms-python.python—— 从 Marketplace 下载最新版，依赖网络且需登录账号才能装私有插件 - 离线安装：
code --install-extension ./python-2024.12.1.vsix—— 路径必须是相对或绝对路径，不能只写文件名；文件权限需为可读（chmod 644 *.vsix） - 重复执行同一命令不会覆盖，但也不会提示“已存在”，得自己查
code --list-extensions确认 - 安装过程无进度条，卡住几秒是正常的；失败时终端会直接输出错误，比如
Extension 'xxx' not found或EPERM
安装后插件不生效？别急着重装
命令行安装只是把文件复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Code\Extensions\（Windows），但 VS Code 主进程未必立刻加载它：
- 必须重启 VS Code（不是仅关闭窗口，要彻底退出进程），否则新插件不会出现在扩展面板
- 某些插件（如需要调试器支持的）还要求打开对应语言文件（如
.py）才会激活 - 如果插件依赖其他扩展（比如 Pylance 依赖 Python 扩展），而依赖项没装，它会显示“已禁用”，需手动启用或补装依赖
最稳妥的验证方式：重启后打开扩展面板（Ctrl+Shift+X），搜索插件名，看状态栏是否显示“已启用”。离线安装的插件右下角还会标出“本地”字样。
