vscode本身不执行webpack打包，真正干活的是webpack或vsce；需确保webpack.config.js文件名正确、置于根目录、用module.exports导出，tasks.json中用npx webpack封装命令并设"panel":"shared"复用终端。
VSCode 本身不打包，真正干活的是 webpack 或 vsce —— 你得把命令配对、路径写准、依赖装全，否则点“运行任务”只是安静地失败。
webpack.config.js 不生效？检查这三处硬性约束
VSCode 插件（比如 Webpack Tools）只读取配置做提示，不执行打包。它识别配置文件非常机械，错一个就静默跳过：
- 文件名必须是
webpack.config.js（或webpack.config.cjs），webpack.prod.js不会被自动探测 - 必须放在项目根目录（即
package.json所在位置），否则插件找不到 - 导出必须用
module.exports = {...}，export default在多数 VSCode 插件中不被识别
如果你用 TypeScript 写配置（webpack.config.ts），VSCode 默认不处理，得额外配 ts-node 启动，这不是推荐路径 —— 直接用 .js 更稳。
tasks.json 里怎么写才能一键触发 webpack 打包
VSCode 的“运行任务”本质就是调终端执行 shell 命令。你要封装的是 npx webpack，不是全局命令，也不是 npm run build：
-
command字段必须写npx webpack --mode production，避免本地项目依赖版本与全局不一致 - 不要用
npm run build：它绕过 VSCode 任务系统，失去错误行号跳转、终端复用等关键能力 -
"panel": "shared"很重要：复用同一个终端面板，否则每次打包都新开窗口，历史堆满还容易误关 - 如果配置文件不在默认路径，加
--config webpack.prod.js显式指定
示例片段（放入 .vscode/tasks.json）：
{
"version": "2.0.0",
"tasks": [
{
"label": "webpack:build",
"type": "shell",
"command": "npx webpack --mode production",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"panel": "shared",
"clear": true
}
}
]
}
打包后插件不加载？重点核对 package.json 的 main 和 externals
Webpack 打包完生成单个 extension.js，但 VSCode 还是按 package.json 里的 main 字段去加载 —— 这里最容易出错：
-
"main": "./out/extension.js"必须和 webpack 的output.path+output.filename完全一致 -
externals: { vscode: "commonjs vscode" }必须存在，否则vscode模块被打进 bundle，运行时报Cannot find module 'vscode' - 如果源码是 TypeScript，确保
entry指向编译后的 JS（如./out/extension.js），而不是./src/extension.ts
常见现象：打包成功、文件生成了，但插件安装后完全没反应 —— 八成是 main 指向了旧路径，或者漏写了 externals。
vsce package 为什么报错 “Cannot resolve ‘fs’” 或 “Module not found”
vsce package 是发布前最后一步，但它不运行 webpack，只按 package.json 的 main 字段打包整个目录。所以：
- 必须先手动跑一次
npx webpack --mode production，确保out/extension.js存在且可用 - 如果
vsce报Cannot resolve 'fs'，说明 webpack 没配target: 'node'，导致它试图按浏览器环境解析 Node 核心模块 - 报
Module not found: Error: Can't resolve 'path'同理，也是target错了或node配置缺失 -
vsce不会自动忽略node_modules—— 你得靠 webpack 把依赖打平，否则插件体积暴涨、启动极慢
真正发布前的最小验证链是：tsc → webpack → 手动检查 out/extension.js 是否可 require → vsce package。
最常被忽略的点：Webpack 打包后，out/ 目录里只有 extension.js 和 sourcemap（如果开了），其他源码、src/、node_modules/ 都不该出现在最终插件包里 —— vsce package 会一并打包进去，除非你用 .vscodeignore 或提前清理。别让 10MB 的 node_modules 混进 2MB 的插件包里。
