vscode插件通过严格路径顺序加载：优先--extensions-dir指定目录，其次默认路径；若该参数错误则插件全部失效。
VSCode插件怎么被找到并加载？关键看 extensions-dir 和扫描顺序
VSCode 启动时不会全局遍历磁盘找插件，而是严格按一个路径列表扫描——最优先的是 --extensions-dir 命令行参数指定的目录，其次才是默认路径。如果该参数被错误设置（比如指向不存在的路径或权限不足的目录），所有插件都会“消失”，哪怕它们明明在 ~/.vscode/extensions 里。
常见错误现象：Extensions: No extensions found 或已安装插件不生效、命令不可用。
- 检查是否误在快捷方式/启动脚本中硬编码了
--extensions-dir，且路径拼写错误或未创建 - Linux/macOS 下注意路径是否含空格或中文，未加引号会导致截断
- Windows 上若用 PowerShell 启动，反斜杠需转义或改用正斜杠：
code --extensions-dir "C:/my/exts" - VSCode 不会自动创建
--extensions-dir指向的目录，必须手动mkdir -p或md
为什么插件装了却没反应？package.json 的 main 和 activationEvents 是关键
插件目录下必须有有效的 package.json，且其中 main 字段指向的入口文件（如 ./out/extension.js）必须存在、可读、语法正确。VSCode 加载失败时通常静默跳过，不报错，只在开发者工具控制台（Developer: Toggle Developer Tools）里输出 Cannot find module 或 require is not defined。
更隐蔽的问题是 activationEvents：它定义插件何时被激活。如果设为 ["onCommand:myext.doSomething"]，但你没调用该命令，插件代码根本不会执行；设为 ["*"] 则一启动就加载，可能拖慢启动速度。
-
main路径是相对于插件根目录的，不是相对于 VSCode 安装目录 - 开发调试时，
npm run compile必须成功生成out/目录，否则main指向的文件不存在 - 修改
activationEvents后需重载窗口（Developer: Reload Window）才生效
~/.vscode/extensions 目录下插件名带版本号，能手动删旧版吗？
可以，而且经常需要——VSCode 不会自动清理旧版本，升级后老版本仍留在磁盘上，占用空间且可能干扰调试（尤其当你本地开发插件时，多个同名不同版本共存易混淆）。删除前确认两点：当前启用的是哪个版本、有没有其他工作区依赖它。
插件文件夹名格式为 publisher-name.extension-name-version，例如 ms-python.python-2024.6.0。VSCode 运行时只加载最新版（按语义化版本比较），但如果你手动停用再启用插件，它可能重新拉取市场最新版，覆盖你本地改过的版本。
- 安全删除方法：先在 UI 中禁用插件 → 关闭 VSCode → 删除对应文件夹 → 重启
- 不要只删
node_modules或out目录，整个文件夹删更彻底 - Linux/macOS 下可用
ls -t ~/.vscode/extensions | head -5查看最近安装的几个插件，辅助判断
跨设备同步插件，靠 settings sync 还是手动复制 extensions 目录？
优先用内置的 settings sync（绑定 GitHub 账号）。它同步的是插件“清单”（ID 列表），而非二进制文件本身。每次登录新设备，VSCode 自动从 Marketplace 下载匹配版本——这意味着你拿到的是官方签名版，不是你本地可能篡改过的副本。
手动复制 ~/.vscode/extensions 目录看似快，但极易出问题：不同系统架构（arm64/x64）、Node.js 版本、VSCode 主版本不兼容时，插件里的原生模块（如 node-gyp 编译产物）会直接崩溃，报错类似 Error: Module version mismatch。
- 同步前确保目标设备网络能访问
https://marketplace.visualstudio.com - 企业环境若禁用了 Marketplace，
settings sync无法安装插件，此时才考虑离线分发 +--extensions-dir指向预置目录 - 备份时，
~/.vscode/extensions目录本身不建议直接打包，应配合code --list-extensions > exts.txt记录 ID 清单
