在调试 Webpack CLI 时，require('webpack') 默认加载的是 node_modules 中的发布版本而非克隆的源码。通过 npm link webpack 将项目依赖指向本地源码，可以在 CLI 调试过程中无缝跳转到 Webpack 核心库源码，实现端到端的断点跟踪。
在 CLI 源码中跟踪到 require('webpack') 时，调试器跳转到了 node_modules/webpack（npm 发布版本），而非我们克隆的源码：
项目结构：
├── webpack-cli/ # 克隆的 CLI 源码（正在调试）
│ └── node_modules/
│ └── webpack/ # npm 安装的发布版本 ← 调试到这里
│
└── webpack/ # 克隆的 webpack 源码（希望调试到这里）# 前提：webpack 源码已链接到全局（环境搭建时完成）
cd /path/to/webpack
npm link
# 在 CLI 项目中链接 webpack
cd /path/to/webpack-cli
npm link webpack| 状态 | node_modules/webpack 指向 |
|---|---|
| 链接前 | npm 仓库发布的版本 |
| 链接后 | 全局 webpack → 本地 webpack 源码 |
在 VS Code 文件资源管理器中，node_modules/webpack 旁会显示箭头图标（→），表示这是一个符号链接而非真实目录。
链接成功后，require('webpack') 将解析到 webpack/lib/index.js：
// webpack/lib/index.js（简化）
// require('webpack') 返回一个懒加载函数：首次调用时才真正加载 webpack 核心模块
const fn = lazyFunction(() => require("./webpack")); // 【断点 1】
module.exports = mergeExports(fn, { /* webpack.Compiler 等懒加载导出 */ });
// webpack/lib/webpack.js（简化）
const webpack = (options, callback) => {
// 【断点 2】进入 createCompiler，创建 Compiler 实例
const compiler = createCompiler(options);
if (callback) {
/* compiler.run(callback) */
}
return compiler;
};webpack/lib/index.js 第 8 行打断点require('webpack') 后自动停在断点createCompiler 方法// webpack/lib/webpack.js — createCompiler()（简化）
const createCompiler = (rawOptions, compilerIndex) => {
// 1. 配置标准化与默认值处理
// 2. 创建 Compiler 实例
const compiler = new Compiler(context, options);
// 3. 挂载内置插件与用户插件
// 4. 初始化文件系统
return compiler;
};# 查看链接关系
ls -la node_modules/webpack
# 输出：webpack -> /path/to/webpack-source-debug/webpack操作系统层面的符号链接（symlink），所有对 node_modules/webpack 的文件访问都会被重定向到源码目录。
| 技巧 | 说明 |
|---|---|
| 符号链接识别 | VS Code 中文件名旁出现箭头图标 |
| 断点验证 | 调试时能进入源码目录的文件即链接成功 |
| 条件断点 | 右键断点可设置触发条件（如 options.mode === 'production'） |
| 调试控制台 | 断点暂停时可执行代码查看变量 |
| 日志断点 | 右键 → "Logpoint" 不暂停只输出日志 |
| 问题 | 解决方案 |
|---|---|
| 链接后调试仍进入 node_modules 旧版本 | 删除 node_modules 重新安装，再执行 npm link webpack |
| Windows 权限问题 | 以管理员身份运行终端 |
| 多版本冲突 | npm unlink webpack 取消链接后重新操作 |
| 链接后 CLI 报模块找不到 | 确认 webpack 源码已执行 yarn install 安装依赖 |
| 修改源码后不生效 | Webpack 是 CommonJS 无需编译，检查是否有缓存（清除 require.cache） |
node -e "console.log(require.resolve('webpack'))" 确认解析路径git pull 同步上游修复上一篇： Webpack CLI build 命令执行流程 下一篇： tapable 核心库详解 — Webpack 插件系统的钩子机制基石