Sourcemap Filter 插件文档

const defaultPatterns = [
  /\/src\/views\/.*\.(vue|js|ts|jsx|tsx)$/,      // 业务页面
  /\/src\/components\/.*\.(vue|js|ts|jsx|tsx)$/, // 业务组件
  /\/src\/utils\/.*\.(js|ts)$/,                  // 工具函数
  /\/src\/option\/.*\.(js|ts)$/,                 // 配置项
  /\/src\/api\/.*\.(js|ts)$/,                    // API 接口
  /\/src\/store\/.*\.(js|ts)$/,                  // 状态管理
  /\/src\/router\/.*\.(js|ts)$/,                 // 路由配置
  /\/src\/hooks\/.*\.(js|ts)$/,                  // 钩子函数
  /\/src\/main\.[jt]s$/,                         // 主入口
  /\/src\/App\.vue$/,                            // 根组件
];

import createSourcemapFilter from './sourcemap-filter.js';

export default function createVitePlugins(env, isBuild) {
  const vitePlugins = [];

  if (isBuild) {
    // 只在构建时启用
    vitePlugins.push(createSourcemapFilter());
  }

  return vitePlugins;
}

// 自定义模式
vitePlugins.push(createSourcemapFilter({
  patterns: [
    /\/src\/views\//,      // 只保留 views 目录
    /\/src\/components\//, // 和 components 目录
  ],
  verbose: true, // 输出详细日志
}));

/**
 * Vite 插件：精细化过滤 sourcemap
 * 只为业务代码生成 sourcemap，排除 node_modules 和第三方库
 * 这样可以在满足 4G/6G 内存限制的同时，保证业务报错的可追溯性
 */
export default function createSourcemapFilter(options = {}) {
  // 定义允许生成 sourcemap 的业务文件夹或文件模式
  const defaultPatterns = [
    /\/src\/views\/.*\.(vue|js|ts|jsx|tsx)$/,      // 所有业务页面
    /\/src\/components\/.*\.(vue|js|ts|jsx|tsx)$/, // 业务公共组件
    /\/src\/utils\/.*\.(js|ts)$/,                  // 工具函数
    /\/src\/option\/.*\.(js|ts)$/,                 // 配置项 (如 Avue 配置)
    /\/src\/api\/.*\.(js|ts)$/,                    // API 接口
    /\/src\/store\/.*\.(js|ts)$/,                  // 状态管理
    /\/src\/router\/.*\.(js|ts)$/,                 // 路由配置
    /\/src\/hooks\/.*\.(js|ts)$/,                  // 钩子函数
    /\/src\/main\.[jt]s$/,                         // 应用主入口
    /\/src\/App\.vue$/,                            // 应用根组件
  ];

  const allowedPatterns = options.patterns || defaultPatterns;
  const verbose = options.verbose || false;

  let filteredCount = 0;
  let allowedCount = 0;

  return {
    name: 'sourcemap-filter-business-only',
    // enforce 配置说明:
    // ❌ 'pre': 在 Vue/TS 编译之前执行
    //   问题：此时 .vue 文件还未转换，sourcemap 还未生成，过早介入无意义
    //
    // ✅ 不设置 (undefined): 在默认阶段执行 【推荐】
    //   优势：Vue/TS 已转换完成，sourcemap 正在生成阶段，正好可以过滤
    //
    // ✅ 'post': 在所有插件之后执行
    //   优势：确保看到最终代码，但对 sourcemap 过滤来说和默认效果相同
    //
    // 当前配置：使用默认顺序（不设置 enforce）
    apply: 'build',

    transform(code, id) {
      // 排除 node_modules
      if (id.includes('node_modules')) {
        filteredCount++;
        if (verbose) {
          console.log(`🚫 [Sourcemap Filter] 跳过 node_modules: ${id}`);
        }
        return { code, map: null };
      }

      // 标准化路径（统一使用正斜杠）
      const normalizedId = id.replace(/\\/g, '/');

      // 检查是否匹配允许的模式
      const isAllowed = allowedPatterns.some(pattern => pattern.test(normalizedId));

      if (!isAllowed) {
        filteredCount++;
        if (verbose) {
          console.log(`🚫 [Sourcemap Filter] 跳过非业务代码: ${normalizedId}`);
        }
        // 对于不匹配的非业务代码，不生成 sourcemap 映射，节省内存
        return { code, map: null };
      }

      allowedCount++;
      if (verbose) {
        console.log(`✅ [Sourcemap Filter] 保留业务代码: ${normalizedId}`);
      }

      // 业务核心代码，保留 sourcemap 用于报错定位
      // 返回 null 表示继续使用默认的 sourcemap 生成逻辑
      return null;
    },

    buildEnd() {
      // 构建结束时输出统计信息
      console.log('\n📊 [Sourcemap Filter] 统计信息:');
      console.log(`   ✅ 保留 sourcemap: ${allowedCount} 个文件`);
      console.log(`   🚫 跳过 sourcemap: ${filteredCount} 个文件`);
      console.log(`   💾 预计节省内存: ~${Math.round((filteredCount / (allowedCount + filteredCount)) * 100)}%\n`);
    },
  };
}