asar打包是目前最直接有效的解法，尤其适合含大量动态require的插件；其他方案如Rollup或.vscodeignore在这类场景下基本失效。
asar 打包是目前最直接有效的解法，尤其适合含大量动态 require 的插件；其他方案如 Rollup 或 .vscodeignore 在这类场景下基本失效。
为什么 node_modules 会让 VSCode 插件安装变慢
VSCode 插件打包工具 vsce 默认把整个项目目录（包括 node_modules）原样塞进 .vsix 文件。一个含 117,317 个文件、185.5 MB 的 node_modules，会导致：
– 安装时解压耗时拉长（尤其 Windows 上 NTFS 小文件写入慢）
– .vsix 体积暴涨，网络传输时间翻倍
– 启动时 VSCode 需扫描所有文件路径，触发大量文件系统调用
这不是“依赖太多”的问题，而是“没压缩、没归档”的问题——Electron 应用（包括 VSCode 自身）早就在用 app/node_modules.asar 解决同类瓶颈。
用 asar 打包替代原始 node_modules
核心思路：把 node_modules 压成单个 node_modules.asar 文件，让 vsce 只打包这个归档，而非数十万小文件。
- 安装
asar：运行npm install --save-dev asar - 在
package.json的scripts中加构建命令："build:asar": "asar pack node_modules node_modules.asar"
- 执行
npm run build:asar，生成node_modules.asar - 在
.vscodeignore中添加：node_modules/
（注意末尾斜杠），确保vsce不再打包原始目录 - 最后运行
vsce package，产物体积通常能降 40%~50%
⚠️ 注意：asar 是只读归档，不能用于写入缓存；若插件中存在 fs.writeFileSync 写入 node_modules 下某路径的行为，必须改到 context.extensionPath 或 os.tmpdir()。
files.watcherExclude 必须同步配，否则开发时照样卡
插件开发阶段，VSCode 仍会监听整个工作区。若 node_modules 没被排除，inotify 句柄堆积会导致编辑器假死、CPU 持续 30%+，和安装慢是同一根源。
在项目根目录的 .vscode/settings.json 中写死以下配置：
"files.watcherExclude": {
"**/node_modules/**": true,
"**/node_modules.asar": true,
"**/dist/**": true,
"**/.git/**": true
}
Linux/macOS 用户还需检查内核限制：cat /proc/sys/fs/inotify/max_user_watches，低于 524288 就要提升，否则即使写了 watcherExclude 也无效。
别碰 rollup —— 动态 require 的插件根本没法 tree-shake
很多插件依赖运行时拼接路径加载模块，比如：require(`./lib/${env}/handler`) 或 require(resolvePluginPath(name))。这类代码：
– rollup 无法静态分析，会漏掉依赖，打包后报 Cannot find module
– webpack 即使配上 ContextReplacementPlugin，也极难覆盖所有动态分支
– .vscodeignore 直接删 node_modules 更不行——插件启动就崩溃
asar 不改变任何运行时逻辑，只是把文件“打包进 ZIP”，Node.js 的 require 机制原生支持从 .asar 中加载，兼容性零风险。
真正容易被忽略的是：asar 打包后，node_modules.asar 本身也要被 files.watcherExclude 排除——它虽是单文件，但 VSCode 仍可能尝试监听其内部结构，尤其当插件启用某些语言服务器时。
