windows上code --install-extension命令路径含空格或中文时必须用双引号包裹，否则shell解析异常导致截断失败；macos/linux需手动注册code命令；插件须解压至严格匹配publisher.name-version格式的目录并彻底重启vscode。
Windows 上 code --install-extension 必须加双引号包裹路径
Windows 下路径含空格或中文时，code --install-extension 会直接报错或静默失败。这不是权限问题，而是 shell 解析异常——PowerShell 或 CMD 遇到空格就截断路径。
- 正确写法：
code --install-extension "C:\my ext\python-2024.6.0.vsix" - 错误写法：
code --install-extension C:\my ext\python.vsix（中间空格导致命令只读到C:\my） - 若用 PowerShell，还可配合
Resolve-Path获取绝对路径再传入，避免手写路径出错
macOS/Linux 的 code 命令默认不可用，需手动注册软链接
macOS 和 Linux 不像 Windows 那样安装时自动注册 code 命令。即使 VSCode 已安装，终端执行 code --version 很可能返回 command not found。
- macOS 推荐做法：运行
sudo ln -s /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code /usr/local/bin/code - Linux（Debian/Ubuntu）：安装后通常已注册；若未生效，先确认是否用了 Snap 安装（
snap install --classic code），Snap 版本的code命令默认可用 - 通用兜底方案：在 VSCode 中按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Linux），输入并执行Shell Command: Install 'code' command in PATH
所有平台的插件解压目录结构必须严格匹配扩展 ID + 版本号
VSCode 不会解压 .vsix 文件到 extensions/ 目录下——它只加载已解压、且目录名完全符合 publisher.name-version 格式的子文件夹。手动复制 .vsix 文件进去，等于白放。
- 先解压验证：
unzip -l prettier.vsix | head -5，看顶层是否为extension/，再查解压后根目录名（如esbenp.prettier-vscode-9.10.3） - 目标路径必须是：
Windows：%USERPROFILE%\.vscode\extensions\esbenp.prettier-vscode-9.10.3\
macOS/Linux：$HOME/.vscode/extensions/esbenp.prettier-vscode-9.10.3/ - 复制完必须彻底退出 VSCode（包括托盘进程），否则 extensions 缓存不刷新，新插件不会加载
ARM 架构设备（如 M 系列 Mac）装错架构插件会静默失效
VSCode 在 Help → About 里显示的括号内容（如 arm64）不是装饰——它决定了能否加载插件里的 native 二进制模块（比如 Pylance、ESBuild）。x64 插件在 arm64 设备上不会报错，但 LSP 服务起不来，补全、跳转等功能全部空白。
- 下载插件时，务必去官方市场页面点击
Download Extension，不要用第三方打包源 - 检查插件兼容性：
unzip -p your.vsix extension/package.json | grep -A2 engines，确认"vscode": "^1.85.0"中的主版本 ≤ 你本地code --version输出的主版本（如1.85.2→ 取1.85） - ARM 设备优先选标有
arm64或universal的插件包；若只有 x64，别硬装
code 命令根本不存在、或者你以为复制了插件，其实只扔了个压缩包进去。这些环节一环断，整个流程就静默失败，连错误提示都不给。
