14. 预构建与缓存目录 ​

// packages/vite/src/node/optimizer/index.ts (简化版)

async function runOptimize(config, deps) {
  const cacheDir = config.optimizerCacheDir; // 通常是 node_modules/.vite

  // 1. 定义 esbuild 构建上下文
  const context = await esbuild.context({
    entryPoints: Object.keys(deps), // ['react', 'react-dom', ...]
    bundle: true,
    format: 'esm',
    splitting: true, // 允许代码分割，优化产物
    outdir: cacheDir, // 输出到缓存目录
    // ... 其他 esbuild 配置
  });

  // 2. 执行构建
  await context.rebuild();

  // 3. 生成元数据文件
  const metadata = {
    hash: getDepHash(config), // 根据 lockfile, package.json 等生成哈希
    optimized: {},
  };

  for (const dep in deps) {
    metadata.optimized[dep] = {
      file: path.resolve(cacheDir, dep + '.js'), // 记录打包后的文件路径
      src: deps[dep], // 记录原始文件路径
    };
  }

  // 将 metadata 写入 _metadata.json
  await fs.writeFile(
    path.join(cacheDir, '_metadata.json'),
    JSON.stringify(metadata, null, 2)
  );
}

// src/optimizer.js

import { build } from 'esbuild';
import path from 'path';
import { promises as fs } from 'fs';

/**
 * 执行预构建
 * @param {string[]} deps - 需要预构建的依赖列表
 * @param {object} config - 项目配置
 */
export async function preBundle(deps, config) {
  const cacheDir = config.cacheDir; // e.g., 'g:/projects/io-books/CoderBooks/mini-vite/node_modules/.mini-vite'
  const metadataPath = path.join(cacheDir, '_metadata.json');

  // 1. 检查缓存是否有效 (简化版：仅检查 metadata 文件是否存在)
  try {
    const metadata = JSON.parse(await fs.readFile(metadataPath, 'utf-8'));
    // 在一个完整的实现中，这里应该有哈希比较
    console.log('缓存有效，跳过预构建。');
    return;
  } catch (e) {
    // 缓存不存在或无效，继续执行
  }

  // 2. 执行 esbuild 打包
  await build({
    entryPoints: deps,
    bundle: true,
    format: 'esm',
    splitting: true,
    outdir: cacheDir,
    write: true, // 确保产物写入磁盘
  });

  // 3. 创建并写入元数据
  const metadata = {
    // 简化版：用时间戳作为哈希
    hash: Date.now().toString(),
    dependencies: deps,
  };

  await fs.mkdir(cacheDir, { recursive: true });
  await fs.writeFile(metadataPath, JSON.stringify(metadata));

  console.log('预构建完成，并已生成缓存。');
}

// 示例：如果 react 和 react-dom 都依赖一个内部的 scheduler 模块
// 开启 splitting 后，产物结构可能是：
// node_modules/.vite/
//   react.js           → import { ... } from './chunk-abc123.js'
//   react-dom.js       → import { ... } from './chunk-abc123.js'
//   chunk-abc123.js    → 共享的 scheduler 代码

// vite.config.js
export default {
  optimizeDeps: {
    // 强制包含某些依赖（即使没有被扫描到）
    // 适用于动态导入、条件导入的依赖
    include: ['lodash-es', 'vue'],
    
    // 排除某些依赖（不进行预构建）
    // 适用于已经是有效 ESM 且没有 CommonJS 依赖的包
    exclude: ['my-esm-only-package'],
    
    // 强制重新预构建（忽略缓存）
    // 当你怀疑缓存出问题时使用
    force: true,
    
    // 自定义 esbuild 配置
    esbuildOptions: {
      // 例如：添加 loader 处理特殊文件
      loader: {
        '.txt': 'text'
      }
    }
  }
}

// 原始 CommonJS 代码（node_modules/some-cjs-lib/index.js）
const utils = require('./utils');
module.exports = {
  foo: utils.bar
};

// esbuild 转换后的 ESM 代码
import utils from './utils.js';
var some_cjs_lib_default = {
  foo: utils.bar
};
export { some_cjs_lib_default as default };

// 动态 require（无法静态分析）
const lib = require(process.env.LIB_NAME);

// 条件导出
if (condition) {
  module.exports = { a: 1 };
} else {
  module.exports = { b: 2 };
}