断点必须打在webpack配置实际执行的位置：函数式配置需在函数体内，插件调试应在apply方法开头，loader调试需在loader函数体内部，且需正确配置sourcemap路径映射和调试启动参数。
断点打在哪才真正生效
Webpack 配置文件本身是 Node.js 脚本，不是前端代码，VSCode 的断点必须落在它被实际执行的位置，而不是“看起来像配置”的地方。常见错误是把断点打在 module.exports = 这行——它只是导出语句，不执行逻辑；真正执行的是函数体内部或插件 apply 方法里。
- 函数式配置
module.exports = (env, argv) => { ... }：断点必须打在花括号内，比如第一行console.log(env);或new HtmlWebpackPlugin()初始化之前 - 插件调试：在
apply(compiler)函数开头打断点，比在new MyPlugin()那行更可靠——后者只是实例化，apply才是 Webpack 调用它的入口 - loader 调试：断点要进 loader 函数体，例如
module: { rules: [{ use: [{ loader: 'babel-loader', options: { ... } }] }] }，得在babel-loader源码或自定义 loader 的function(source) { debugger; return source; }里打，不是在require('babel-loader')那行
Ctrl+P 跳转到 webpack.config.js 但没提示？
VSCode 不会自动识别任意 webpack.config.js 文件，它依赖路径、命名和导出方式三重约束。跳转能成功，不代表语法提示或调试支持就到位。
- 文件必须和
package.json同目录（项目根目录），否则插件找不到它 - 名字必须是
webpack.config.js或webpack.config.cjs；.ts后缀默认不识别，除非你额外配了ts-node启动器 - 导出必须用
module.exports = { ... }，export default在多数插件（如官方 “webpack” 插件）中会失效，导致没有智能提示 - 如果用了
path.resolve()，确保顶部有const path = require('path');，否则路径补全和类型推导全挂
F5 启动调试但卡住不动？检查 runtimeExecutable
VSCode 默认用 node 执行脚本，但很多 launch.json 错误地设成 "runtimeExecutable": "npm"，结果 npm 启动后又 fork 出 node 进程，VSCode 的调试器就跟丢了。
- 正确做法：设
"runtimeExecutable": "node"，再通过"runtimeArgs"传完整命令，例如：["--inspect-brk=9229", "./node_modules/webpack/bin/webpack.js", "--config", "webpack.config.js"] - 不要用
"program": "npm"+"args": ["run", "build"]，这会让调试器附着在 npm 上，而不是真正的 Webpack 进程 - Windows 用户注意：
./node_modules/.bin/webpack.cmd是批处理文件，不能直接被 node 执行；必须用./node_modules/webpack/bin/webpack.js - 端口冲突时，
--inspect-brk=9229可换为9230等未占用端口，launch.json 中的"port"必须严格一致
为什么断点变空心圆？sourceMapPathOverrides 没配对
Webpack 打包后的代码和源码映射失败时，VSCode 不报错，只让断点变空心圆——这是最隐蔽的调试失败信号。问题不在代码，而在路径映射规则。
- 如果配置里用了
devtool: 'source-map'，但没在 launch.json 里加"sourceMaps": true和"sourceMapPathOverrides"，断点必然失效 - 典型映射写法：
{"webpack:///./*": "${workspaceFolder}/*"}，适用于大多数默认配置；若 output.path 设为path.resolve(__dirname, 'dist')，则源码路径前缀可能是webpack:///./，需对应调整 - 验证方法：在 Chrome DevTools 的 Sources 面板里展开 webpack://，看能否看到你的
webpack.config.js；看不到，就是映射没对上 - 别依赖自动推导——VSCode 的自动 sourceMap 推导在 Webpack 配置场景下极不可靠，必须手动配
