hw-weapp-compiler 1.0.21 → 1.0.23

package/README.md

@@ -1,119 +1,76 @@
-# hw-weapp-compiler
+# weapp-compiler
 
-基于 webpack 5 的原生微信小程序构建工具，支持 JavaScript、Less、WXML、WXS、分包、npm 组件和可选的 OBS/OSS 静态资源上传。
 
-## 环境要求
+## 版本改动
 
-- Node.js 18～24
-- 项目源码位于 `src/`
-- 必须存在 `src/app.json` 和 `src/app.js`
+1. **OpenSSL 3.0 兼容**: Node.js >= 17 时自动注入 `--openssl-legacy-provider`
+2. **wxml-loader 空值守卫**: `loadModule` 失败时不再崩溃
 
 ## 安装
 
 ```bash
-npm install hw-weapp-compiler@1 -D
-```
-
-升级版本后如果出现 `Cannot find module`，请删除业务项目中旧的安装产物并重新执行 `npm install`，确保传递依赖与 lockfile 同步。
-
-在业务项目的 `package.json` 中添加：
-
-```json
-{
-  "scripts": {
-    "dev": "hw-weapp dev",
-    "build": "hw-weapp build"
-  }
-}
+npm i weapp-compiler@2.x -D
 ```
 
 ## 使用
 
 ```bash
-# 开发监听，默认 development
-npm run dev
-
-# 指定预发或生产业务环境
-npm run dev -- --simulation
-npm run dev -- --production
-
-# 生产构建，默认 production
-npm run build
-npm run build -- --development
-npm run build -- --simulation
+# 开发调试
+npm run dev        # 测试环境
+npm run dev -s     # 预发环境
+npm run dev -p     # 生产环境
+
+# 生产发布
+npm run build -d   # 测试环境
+npm run build -s   # 预发环境
+npm run build      # 生产环境
 ```
 
-可用选项：
-
-- `-d, --development`：测试环境
-- `-s, --simulation`：预发环境
-- `-p, --production`：生产环境
-- `-a, --analyzer`：打开 webpack bundle analyzer
-- `-q, --quiet`：关闭 webpack 进度输出
-
-最终环境会通过 `process.env.BUILD_ENV` 注入代码，并记录到 `dist/weapp.env.json`。
-
 ## 配置
 
-在项目根目录创建 `.weapp.js`，最小配置为：
-
-```js
-module.exports = {};
-```
-
-完整示例：
+项目根目录下创建 `.weapp.js`：
 
 ```js
 const path = require('path');
 
 module.exports = {
+  // 路径别名
   alias: {
     '@utils': path.resolve(__dirname, 'src/utils'),
+    '@config': path.resolve(__dirname, 'src/config'),
   },
+  // 资源公共路径
   publicPath: 'https://cdn.example.com/weapp/',
-  copyFiles: [
-    { from: 'images', to: 'images' },
-  ],
-};
-```
-
-## 静态资源上传
-
-上传是可选功能，只能配置 OBS 或 OSS 中的一种。生产构建会等待上传完成，任何上传失败都会让构建失败；编译失败时不会上传半成品。
-
-建议从环境变量读取凭据，避免把密钥提交到仓库：
-
-```js
-module.exports = {
-  obsConfig: process.env.OBS_ACCESS_KEY_ID
-    ? {
-        access_key_id: process.env.OBS_ACCESS_KEY_ID,
-        secret_access_key: process.env.OBS_SECRET_ACCESS_KEY,
-        server: process.env.OBS_SERVER,
-        bucket: process.env.OBS_BUCKET,
-        dir: 'weapp',
-      }
-    : undefined,
+  // 要同步的目录
+  copyFiles: [{
+    from: 'images',
+    to: 'images',
+  }],
+  // OBS 或 OSS 配置（二选一）
+  obsConfig: {
+    access_key_id: 'XXX',
+    secret_access_key: 'XXX',
+    server: 'XXX',
+    bucket: 'XXX',
+    dir: 'weapp',
+  },
+  ossConfig: {
+    region: '<Your region>',
+    accessKeyId: '<Your AccessKeyId>',
+    accessKeySecret: '<Your AccessKeySecret>',
+    bucket: '<Your Bucket>',
+    dir: 'weapp',
+  },
 };
 ```
 
-OSS 配置字段为 `region`、`accessKeyId`、`accessKeySecret`、`bucket` 和 `dir`。
-
-## 开发监听限制
-
-修改已有文件可以正常增量构建。开发监听期间新增页面、组件、分包，或后创建同名 `.less`、`.wxss`、`.wxml`、`.json` 文件后，需要重新启动 `dev`。生产 `build` 每次都会重新读取完整项目配置。
-
-## 微信开发者工具配置
-
-如果资源使用 CDN 上传，可以在 `src/project.config.json` 中忽略本地产物：
+在 `project.config.json` 中忽略构建产物：
 
 ```json
-{
-  "packOptions": {
-    "ignore": [
-      { "type": "folder", "value": "assets" },
-      { "type": "regexp", "value": "\\.map$" }
-    ]
-  }
+"packOptions": {
+  "ignore": [
+    { "type": "folder", "value": "assets" },
+    { "type": "regexp", "value": "\\.map$" }
+  ]
 }
 ```

package/build/config/getConfig.js

@@ -56,9 +56,6 @@ ossConfig: {
 `),
   );
 }
-if (config.obsConfig && config.ossConfig) {
-  throw new TypeError('.weapp.js 不能同时配置 obsConfig 和 ossConfig');
-}
 const alias = {
   ...(config.alias || {}),
 };

package/build/dev.js

@@ -1,5 +1,4 @@
 const webpack = require('webpack');
-const chalk = require('chalk');
 const { ENV } = require('./config/constants');
 const webpackConfig = require('./webpack.config');
 const { createCompilerHandler } = require('./utils/createCompilerHandler');
@@ -21,7 +20,7 @@ module.exports = async (opts) => {
     ),
   );
 
-  const watching = compiler.watch(
+  compiler.watch(
     {
       aggregateTimeout: 300,
       poll: false,
@@ -29,9 +28,4 @@ module.exports = async (opts) => {
     },
     createCompilerHandler('dev'),
   );
-
-  if (!opts || opts.quiet !== true) {
-    console.log(chalk.cyan('dev 正在监听文件变化'));
-  }
-  return watching;
 };

package/build/plugin/index.js

@@ -9,25 +9,10 @@ const { RawSource } = require('webpack-sources');
 
 const { addToUploadQueue } = require('../utils/upload');
 const { compatiblePath } = require('../utils/compatiblePath');
-const { ENV, PATTERNS, ASSET_EXT_PATTERN, ASSETS_DIR } = require('../config/constants');
+const { PATTERNS, ASSET_EXT_PATTERN, ASSETS_DIR } = require('../config/constants');
 
 const pluginName = 'WeappCompilerPlugin';
 
-async function uploadCompilationAssets(stats, compiler, assets, upload = addToUploadQueue) {
-  if (stats.hasErrors() || assets.length === 0) {
-    return;
-  }
-
-  try {
-    await upload(assets);
-  } catch (error) {
-    if (compiler.options.mode === ENV.PROD) {
-      throw error;
-    }
-    compiler.getInfrastructureLogger(pluginName).error(error);
-  }
-}
-
 /**
  * 检测产物中存在哪些公共模块和分包模块
  */
@@ -91,19 +76,13 @@ function injectGlobalModules(content, assetName, flags) {
 
   // runtime 暴露到全局
   if (assetName === 'runtime.js') {
-    const runtimeCachePattern = /\b(var|let|const)\s+__webpack_module_cache__\s*=\s*\{\};/;
-    if (!runtimeCachePattern.test(result)) {
-      throw new Error(
-        '无法注入微信小程序 runtime：当前 webpack 产物中缺少 module cache 标记，请检查 webpack 版本',
-      );
-    }
     result = result.replace(
-      runtimeCachePattern,
-      (statement, declaration) => `
+      'var __webpack_module_cache__ = {};',
+      `
         if (!global.__webpack_module_cache__) {
           global.__webpack_module_cache__ = {};
         }
-        ${declaration} __webpack_module_cache__ = global.__webpack_module_cache__;
+        var __webpack_module_cache__ = global.__webpack_module_cache__;
         global.__webpack_require__ = __webpack_require__;
       `,
     );
@@ -188,10 +167,9 @@ class WeappPlugin {
   apply(compiler) {
     let obsAssets = [];
 
-    compiler.hooks.done.tapPromise(pluginName, async (stats) => {
-      const assets = Array.from(new Set(obsAssets));
+    compiler.hooks.done.tap(pluginName, () => {
+      addToUploadQueue([...obsAssets]);
       obsAssets = [];
-      await uploadCompilationAssets(stats, compiler, assets);
     });
 
     compiler.hooks.compilation.tap(pluginName, (compilation) => {
@@ -250,7 +228,3 @@ class WeappPlugin {
 }
 
 module.exports = WeappPlugin;
-module.exports._internals = {
-  injectGlobalModules,
-  uploadCompilationAssets,
-};

package/build/prod.js

@@ -3,7 +3,7 @@ const TerserPlugin = require('terser-webpack-plugin');
 const CssMinimizerPlugin = require('css-minimizer-webpack-plugin');
 const { ENV } = require('./config/constants');
 const webpackConfig = require('./webpack.config');
-const { createCompilerHandler, runCompilerOnce } = require('./utils/createCompilerHandler');
+const { createCompilerHandler } = require('./utils/createCompilerHandler');
 
 module.exports = async (opts) => {
   // 生产环境禁用 filesystem cache，与 dev 同源：output.clean 后复用旧缓存会导致副作用产物漏生成，
@@ -34,5 +34,5 @@ module.exports = async (opts) => {
     ),
   );
 
-  await runCompilerOnce(compiler, createCompilerHandler('build'));
+  compiler.run(createCompilerHandler('build'));
 };

package/build/utils/createCompilerHandler.js

@@ -48,26 +48,6 @@ function createCompilerHandler(label, { failOnError = label === 'build' } = {})
   };
 }
 
-/**
- * 运行一次 webpack 编译，并等待异步 done 钩子及 compiler.close 完成。
- * 上传任务挂在 done.tapPromise 上，生产命令必须等待这里结束，才能可靠输出上传错误。
- */
-function runCompilerOnce(compiler, handler) {
-  return new Promise((resolve, reject) => {
-    compiler.run((runError, stats) => {
-      compiler.close((closeError) => {
-        try {
-          handler(runError || closeError, stats);
-          resolve(stats);
-        } catch (error) {
-          reject(error);
-        }
-      });
-    });
-  });
-}
-
 module.exports = {
   createCompilerHandler,
-  runCompilerOnce,
-};
+};

package/build/utils/getWxmlAssets.js

@@ -3,43 +3,27 @@ const path = require('path');
 const fse = require('fs-extra');
 const { ASSET_EXT_PATTERN, PATTERNS, SRC_DIR } = require('../config/constants');
 
-function extractStyleUrls(style) {
-  const urls = [];
-  const urlPattern = /url\(\s*(?:(['"])(.*?)\1|([^)]*?))\s*\)/gi;
-  let match;
-
-  // eslint-disable-next-line no-cond-assign
-  while ((match = urlPattern.exec(style)) !== null) {
-    const value = (match[2] !== undefined ? match[2] : match[3]).trim();
-    if (value) {
-      urls.push(value);
-    }
-  }
-  return urls;
-}
-
 function getWxmlAssets(filePath, content) {
   const resolvePath = (attr, dir) => {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve) => {
       const isAbsolutePath = PATTERNS.ABSOLUTE_PATH.test(attr);
       const request = isAbsolutePath ? attr.replace(PATTERNS.ABSOLUTE_PATH, '') : attr;
       const resolveContext = isAbsolutePath ? SRC_DIR : dir;
 
       this.resolve(resolveContext, request, async (err, result) => {
-        try {
-          let res = result;
-          if (err) {
-            const fallbackPath = path.resolve(resolveContext, request);
+        let res = result;
+        if (err) {
+          const fallbackPath = path.resolve(resolveContext, request);
 
-            if (await fse.pathExists(fallbackPath)) {
-              res = fallbackPath;
-            } else {
-              this.emitError(err);
-            }
+          if (await fse.pathExists(fallbackPath)) {
+            res = fallbackPath;
+            resolve(res);
+          } else {
+            this.emitError(err);
+            resolve(res);
           }
+        } else {
           resolve(res);
-        } catch (error) {
-          reject(error);
         }
       });
     });
@@ -47,7 +31,8 @@ function getWxmlAssets(filePath, content) {
   return new Promise((resolve, reject) => {
     let allAttrs = [];
     const parser = new htmlparser2.Parser({
-      onopentag: (name, attributes) => {
+      onopentag: async (name, attributes) => {
+        const reg = /url\(.*\)/g;
         const { style } = attributes;
 
         allAttrs = allAttrs.concat(
@@ -58,53 +43,60 @@ function getWxmlAssets(filePath, content) {
         );
 
         if (style) {
-          allAttrs = allAttrs.concat(extractStyleUrls(style));
+          const styles = attributes.style.split(';');
+          styles.forEach((styleItem) => {
+            (styleItem.match(reg) || []).forEach((item) => {
+              allAttrs.push(
+                item
+                  .replace(/^(url\(”)/g, '')
+                  .replace(/^(url\(')/g, '')
+                  .replace(/^(url\()/g, '')
+                  .replace(/(“\)|'\)|\))$/g, ''),
+              );
+            });
+          });
         }
       },
       onerror: (err) => {
         reject(err);
       },
       onend: async () => {
-        try {
-          const filteredAttrs = allAttrs
-            .filter((item) => !!item)
-            .map((item) => item.split('?')[0])
-            .filter((item) => !/^(?:https?:)?\/\//i.test(item))
-            .filter((item) => !/{{.*}}/.test(item))
-            .filter((item) => !/\+.*\+/.test(item));
+        const filteredAttrs = allAttrs
+          .filter((item) => !!item)
+          .map((item) => item.split('?')[0])
+          .filter((item) => !/^(http:|https:)/.test(item))
+          .filter((item) => !/{{.*}}/.test(item))
+          .filter((item) => !/\+.*\+/.test(item));
 
-          const assets = filteredAttrs.filter((item) => ASSET_EXT_PATTERN.test(item));
-          const wxmls = filteredAttrs.filter((item) => PATTERNS.WXS_EXT.test(item) || PATTERNS.WXML_EXT.test(item));
+        const assets = filteredAttrs.filter((item) => ASSET_EXT_PATTERN.test(item));
+        const wxmls = filteredAttrs.filter((item) => PATTERNS.WXS_EXT.test(item) || PATTERNS.WXML_EXT.test(item));
 
-          const assetsImports = [];
-          const wxmlsImports = [];
+        const assetsImports = [];
+        const wxmlsImports = [];
 
-          // 并行解析 wxml 路径
-          const wxmlResults = await Promise.all(
-            wxmls.map(async (attr) => {
-              const result = await resolvePath(attr, path.parse(filePath).dir);
-              return result ? [attr, result] : null;
-            }),
-          );
-          for (let index = 0; index < wxmlResults.length; index += 1) {
-            if (wxmlResults[index]) wxmlsImports.push(wxmlResults[index]);
-          }
-
-          // 并行解析 asset 路径
-          const assetResults = await Promise.all(
-            assets.map(async (attr) => {
-              const result = await resolvePath(attr, path.parse(filePath).dir);
-              return result ? [attr, result] : null;
-            }),
-          );
-          for (let index = 0; index < assetResults.length; index += 1) {
-            if (assetResults[index]) assetsImports.push(assetResults[index]);
-          }
+        // 并行解析 wxml 路径
+        const wxmlResults = await Promise.all(
+          wxmls.map(async (attr) => {
+            const result = await resolvePath(attr, path.parse(filePath).dir);
+            return result ? [attr, result] : null;
+          }),
+        );
+        for (let index = 0; index < wxmlResults.length; index += 1) {
+          if (wxmlResults[index]) wxmlsImports.push(wxmlResults[index]);
+        }
 
-          resolve([assetsImports, wxmlsImports]);
-        } catch (error) {
-          reject(error);
+        // 并行解析 asset 路径
+        const assetResults = await Promise.all(
+          assets.map(async (attr) => {
+            const result = await resolvePath(attr, path.parse(filePath).dir);
+            return result ? [attr, result] : null;
+          }),
+        );
+        for (let index = 0; index < assetResults.length; index += 1) {
+          if (assetResults[index]) assetsImports.push(assetResults[index]);
         }
+
+        resolve([assetsImports, wxmlsImports]);
       },
     });
     parser.write(content);
@@ -114,5 +106,4 @@ function getWxmlAssets(filePath, content) {
 
 module.exports = {
   getWxmlAssets,
-  extractStyleUrls,
 };

package/build/utils/upload.js

@@ -16,70 +16,18 @@ const { DIST_DIR } = require('../config/constants');
 
 const { obsConfig, ossConfig } = getConfig();
 
-let obsClientPromise;
+let obsClient;
 let ossClient;
-
-function getObsResponseError(action, result) {
-  const commonMsg = result && result.CommonMsg;
-  const rawStatus = commonMsg && commonMsg.Status;
-  const status = Number(rawStatus);
-
-  if (
-    rawStatus === undefined ||
-    rawStatus === null ||
-    (typeof rawStatus === 'string' && rawStatus.trim() === '') ||
-    !Number.isFinite(status)
-  ) {
-    return new Error(`OBS ${action} failed: invalid response`);
-  }
-  if (status >= 200 && status < 300) {
-    return null;
-  }
-
-  const details = [
-    `status ${status}`,
-    commonMsg.Code && `code ${commonMsg.Code}`,
-    commonMsg.Message && commonMsg.Message,
-  ].filter(Boolean);
-  return new Error(`OBS ${action} failed with ${details.join(', ')}`);
-}
-
-function createObsCallback(action, resolve, reject) {
-  return (error, result) => {
-    if (error) {
-      reject(error);
-      return;
-    }
-
-    const responseError = getObsResponseError(action, result);
-    if (responseError) {
-      reject(responseError);
-    } else {
-      resolve(result);
-    }
-  };
-}
-
-async function initializeObsClient(Client = OBSClient, config = obsConfig) {
-  const client = new Client({ ...config });
-
-  // esdk-obs-nodejs 3.26.x 的构造函数不会等待异步 initFactory()。
-  // 静态 AK/SK 初始化会在下一个微任务完成，立即调用 API 时 signatureContext 仍为 null。
-  await Promise.resolve();
-  if (!client.util || !client.util.signatureContext) {
-    throw new Error('OBS client initialization failed');
-  }
-  return client;
-}
+let progress;
+let uploadQueue = {};
 
 function getObsClient() {
-  if (!obsClientPromise) {
-    obsClientPromise = initializeObsClient().catch((error) => {
-      obsClientPromise = undefined;
-      throw error;
+  if (!obsClient) {
+    obsClient = new OBSClient({
+      ...obsConfig,
     });
   }
-  return obsClientPromise;
+  return obsClient;
 }
 
 function getOssClient() {
@@ -102,28 +50,42 @@ function getOssStat(file) {
   return getOssClient().head(compatiblePath(path.join(ossConfig.dir, path.relative(DIST_DIR, file))));
 }
 
-async function doObsUpload(file) {
-  const client = await getObsClient();
+function doObsUpload(file) {
   return new Promise((resolve, reject) => {
-    client.putObject(
+    getObsClient().putObject(
       {
         Bucket: obsConfig.bucket,
         Key: compatiblePath(path.join(obsConfig.dir, path.relative(DIST_DIR, file))),
         SourceFile: file,
       },
-      createObsCallback('upload', resolve, reject),
+      (err, result) => {
+        if (err) {
+          reject(err);
+        } else if (result.CommonMsg.Status >= 300) {
+          reject(new Error(`OBS upload failed with status ${result.CommonMsg.Status}`));
+        } else {
+          resolve(result);
+        }
+      },
     );
   });
 }
 async function getObsStat(file) {
-  const client = await getObsClient();
   return new Promise((resolve, reject) => {
-    client.getObjectMetadata(
+    getObsClient().getObjectMetadata(
       {
         Bucket: obsConfig.bucket,
         Key: compatiblePath(path.join(obsConfig.dir, path.relative(DIST_DIR, file))),
       },
-      createObsCallback('metadata request', resolve, reject),
+      (err, result) => {
+        if (err) {
+          reject(err);
+        } else if (result.CommonMsg.Status < 300) {
+          resolve(result);
+        } else {
+          reject(result);
+        }
+      },
     );
   });
 }
@@ -148,64 +110,77 @@ function doUpload(file) {
   return doObsUpload(file);
 }
 
-async function uploadFile(file) {
-  try {
-    await getStat(file);
-  } catch (error) {
-    await doUpload(file);
+function updateProgress() {
+  const completed =
+    Object.entries(uploadQueue).filter((item) => item[1] === 'completed').length + 1;
+  const total = Object.keys(uploadQueue).length;
+
+  if (!progress) {
+    progress = new Progress('uploading assets [:bar] :current/:total', {
+      total,
+      width: 40,
+      clear: true,
+    });
+  }
+
+  progress.tick();
+
+  if (completed === total) {
+    progress.tick({
+      current: total,
+    });
+    progress = null;
+    uploadQueue = {};
   }
-  setStorage(file, true);
+
+  return `[${completed}/${total}]`;
 }
 
-async function uploadFiles(files, task = uploadFile) {
-  const failures = [];
-  const progress = new Progress('uploading assets [:bar] :current/:total', {
-    total: files.length,
-    width: 40,
-    clear: true,
-  });
+async function checkUpload() {
+  const files = Object.entries(uploadQueue)
+    .filter((item) => item[1] === false)
+    .splice(0, 10);
 
-  for (let index = 0; index < files.length; index += 10) {
-    const batch = files.slice(index, index + 10);
+  if (files && files.length) {
     await Promise.all(
-      batch.map(async (file) => {
+      files.map(async (file) => {
+        uploadQueue[file[0]] = 'uploading';
         try {
-          await task(file);
+          await getStat(file[0]);
+          setStorage(file[0], true);
+          updateProgress();
         } catch (error) {
-          failures.push({ file, error });
-        } finally {
-          progress.tick();
+          try {
+            await doUpload(file[0]);
+            setStorage(file[0], true);
+          } catch (uploadError) {
+            console.error(`Failed to upload ${file[0]}:`, uploadError);
+          }
+          updateProgress();
         }
+        uploadQueue[file[0]] = 'completed';
       }),
     );
-  }
 
-  if (failures.length > 0) {
-    const details = failures
-      .map(({ file, error }) => `${file}: ${error && error.message ? error.message : error}`)
-      .join('\n');
-    const error = new Error(`Failed to upload ${failures.length} asset(s):\n${details}`);
-    error.failures = failures;
-    throw error;
+    checkUpload();
   }
 }
 
-async function addToUploadQueue(assets) {
-  if ((!obsConfig && !ossConfig) || assets.length === 0) {
+function addToUploadQueue(assets) {
+  if (!obsConfig && !ossConfig) {
+    console.warn('请配置obsConfig 或 ossConfig，否则无法上传文件到obs 或 oss');
     return;
   }
 
-  const files = Array.from(new Set(assets.map((asset) => path.resolve(DIST_DIR, asset))));
-  await uploadFiles(files);
+  assets.forEach((asset) => {
+    const file = path.resolve(DIST_DIR, asset);
+    if (uploadQueue[file] === undefined) {
+      uploadQueue[file] = false;
+    }
+  });
+  checkUpload();
 }
 
 module.exports = {
   addToUploadQueue,
-  _internals: {
-    createObsCallback,
-    getObsResponseError,
-    initializeObsClient,
-    uploadFile,
-    uploadFiles,
-  },
 };

package/build/webpack.config.js

@@ -180,13 +180,13 @@ module.exports = async (options, { analyzer, quiet } = {}) => {
         loader: MiniCssExtractPlugin.loader,
       },
       {
-        loader: require.resolve('css-loader'),
+        loader: 'css-loader',
         options: {
           importLoaders: use.length + 1,
         },
       },
       {
-        loader: require.resolve('postcss-loader'),
+        loader: 'postcss-loader',
         options: {
           postcssOptions: {
             plugins: [
@@ -239,16 +239,14 @@ module.exports = async (options, { analyzer, quiet } = {}) => {
     });
   });
 
-  if (patterns.length > 0) {
-    plugins.push(
-      new CopyPlugin({
-        patterns,
-        options: {
-          concurrency: 100,
-        },
-      }),
-    );
-  }
+  plugins.push(
+    new CopyPlugin({
+      patterns,
+      options: {
+        concurrency: 100,
+      },
+    }),
+  );
 
   return merge(
     {
@@ -277,12 +275,12 @@ module.exports = async (options, { analyzer, quiet } = {}) => {
             test: ASSET_EXT_PATTERN,
             use: [
               {
-                loader: require.resolve('url-loader'),
+                loader: 'url-loader',
                 options: {
                   limit: 0,
                   esModule: false,
                   fallback: {
-                    loader: require.resolve('file-loader'),
+                    loader: 'file-loader',
                     options: {
                       name: `${ASSETS_DIR}/[name].[hash].[ext]`,
                     },
@@ -303,7 +301,7 @@ module.exports = async (options, { analyzer, quiet } = {}) => {
               ...getCssLoader({
                 use: [
                   {
-                    loader: require.resolve('less-loader'),
+                    loader: 'less-loader',
                     options: {
                       lessOptions() {
                         return {
@@ -321,7 +319,7 @@ module.exports = async (options, { analyzer, quiet } = {}) => {
             type: 'javascript/auto',
             use: [
               {
-                loader: require.resolve('file-loader'),
+                loader: 'file-loader',
                 options: {
                   name: assetsName,
                 },
@@ -333,7 +331,7 @@ module.exports = async (options, { analyzer, quiet } = {}) => {
             type: 'javascript/auto',
             use: [
               {
-                loader: require.resolve('file-loader'),
+                loader: 'file-loader',
                 options: {
                   name: assetsName,
                 },
@@ -347,7 +345,7 @@ module.exports = async (options, { analyzer, quiet } = {}) => {
             test: /\.(wxml)$/i,
             use: [
               {
-                loader: require.resolve('file-loader'),
+                loader: 'file-loader',
                 options: {
                   name: assetsName,
                 },

package/index.js

@@ -1,14 +1,27 @@
 #!/usr/bin/env node
 
+// 高版本 Node.js (>=17) 兼容 OpenSSL 3.0
+const nodeMajor = process.versions.node.split('.')[0];
+if (nodeMajor >= 17) {
+  process.env.NODE_OPTIONS = `${process.env.NODE_OPTIONS || ''} --openssl-legacy-provider`.trim();
+}
+
 const { program } = require('commander');
 const path = require('path');
 const fs = require('fs');
+const dev = require('./build/dev');
+const prod = require('./build/prod');
 const { setBuildEnv } = require('./build/utils/buildEnv');
 const { ENV } = require('./build/config/constants');
 
 const { version } = JSON.parse(
   fs.readFileSync(path.resolve(__dirname, './package.json')).toString(),
 );
+const compiler = {
+  dev,
+  prod,
+};
+
 program.version(version);
 program.option('-a, --analyzer', 'webpack-bundle-analyzer');
 program.option('-s, --simulation', 'process.env.BUILD_ENV = simulation');
@@ -16,27 +29,25 @@ program.option('-d, --development', 'process.env.BUILD_ENV = development');
 program.option('-p, --production', 'process.env.BUILD_ENV = production');
 program.option('-q, --quiet', '安静模式，打印减少');
 
-program.command('dev').action(async () => {
+program.command('dev').action(() => {
   setBuildEnv({
     mode: ENV.DEV,
     ...program.opts(),
   });
-  // 延迟加载构建模块，保证 --help/--version 不依赖业务项目配置。
-  // eslint-disable-next-line global-require
-  const dev = require('./build/dev');
-  await dev(program.opts());
+  compiler.dev(program.opts()).catch((err) => {
+    console.error(err);
+    process.exitCode = 1;
+  });
 });
-program.command('build').action(async () => {
+program.command('build').action(() => {
   setBuildEnv({
     mode: ENV.PROD,
     ...program.opts(),
   });
-  // eslint-disable-next-line global-require
-  const prod = require('./build/prod');
-  await prod(program.opts());
+  compiler.prod(program.opts()).catch((err) => {
+    console.error(err);
+    process.exitCode = 1;
+  });
 });
 
-program.parseAsync(process.argv).catch((err) => {
-  console.error(err);
-  process.exitCode = 1;
-});
+program.parse(process.argv);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hw-weapp-compiler",
-  "version": "1.0.21",
-  "description": "基于 webpack5 的小程序构建工具，兼容 Node.js 18~24",
+  "version": "1.0.23",
+  "description": "基于 webpack5 的小程序构建工具，兼容 Node.js 14~24",
   "main": "index.js",
   "bin": {
     "hw-weapp": "index.js"
@@ -12,7 +12,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=14.17.1"
   },
   "dependencies": {
     "@swc/core": "^1.15.43",
@@ -30,8 +30,7 @@
     "file-loader": "^6.2.0",
     "fs-extra": "^9.1.0",
     "htmlparser2": "^6.0.1",
-    "isobject": "3.0.1",
-    "less": "4.6.7",
+    "less": "^4.1.1",
     "less-loader": "^8.0.0",
     "loader-utils": "^2.0.0",
     "mini-css-extract-plugin": "^1.6.0",
@@ -42,7 +41,7 @@
     "terser-webpack-plugin": "^5.6.1",
     "throttle-debounce": "^3.0.1",
     "url-loader": "^4.1.1",
-    "webpack": "5.108.4",
+    "webpack": "^5.61.0",
     "webpack-bundle-analyzer": "^4.4.0",
     "webpack-merge": "^5.7.3",
     "webpack-sources": "^2.2.0"
@@ -53,7 +52,6 @@
   "scripts": {
     "build": "node ./index.js build",
     "dev": "nodemon --inspect --trace-deprecation --watch build ./index.js dev",
-    "simulation": "node ./index.js build -s",
-    "test": "node --test"
+    "simulation": "node ./index.js build -s"
   }
 }

package/test-support/mini-program.js

@@ -1,49 +0,0 @@
-const fs = require('node:fs');
-const path = require('node:path');
-const vm = require('node:vm');
-
-function executeMiniProgramDist(dist, entries = ['app.js', 'pages/index/index.js']) {
-  const sandbox = {
-    console,
-    appConfig: null,
-    pageConfig: null,
-  };
-  sandbox.global = sandbox;
-  sandbox.App = (config) => {
-    sandbox.appConfig = config;
-  };
-  sandbox.Page = (config) => {
-    sandbox.pageConfig = config;
-  };
-
-  const context = vm.createContext(sandbox);
-  const moduleCache = new Map();
-
-  const load = (request, from = 'app.js') => {
-    let filename = path.posix.normalize(path.posix.join(path.posix.dirname(from), request));
-    if (!path.posix.extname(filename)) {
-      filename += '.js';
-    }
-    if (moduleCache.has(filename)) {
-      return moduleCache.get(filename).exports;
-    }
-
-    const loadedModule = { exports: {} };
-    moduleCache.set(filename, loadedModule);
-    const source = fs.readFileSync(path.join(dist, ...filename.split('/')), 'utf8');
-    const wrapper = vm.runInContext(
-      `(function (require, module, exports) { ${source}\n })`,
-      context,
-      { filename },
-    );
-    wrapper((child) => load(child, filename), loadedModule, loadedModule.exports);
-    return loadedModule.exports;
-  };
-
-  for (const entry of entries) {
-    load(`./${entry}`);
-  }
-  return sandbox;
-}
-
-module.exports = { executeMiniProgramDist };

package/test-support/project.js

@@ -1,25 +0,0 @@
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-
-function createTempProject(prefix = 'hw-weapp-test-') {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
-
-  return {
-    root,
-    resolve(...segments) {
-      return path.join(root, ...segments);
-    },
-    write(relativePath, content) {
-      const filename = path.join(root, relativePath);
-      fs.mkdirSync(path.dirname(filename), { recursive: true });
-      fs.writeFileSync(filename, content);
-      return filename;
-    },
-    cleanup() {
-      fs.rmSync(root, { recursive: true, force: true });
-    },
-  };
-}
-
-module.exports = { createTempProject };

package/test-support/webpack.js

@@ -1,80 +0,0 @@
-const Module = require('node:module');
-const webpack = require('webpack');
-
-function runCompiler(config) {
-  const compiler = webpack(config);
-
-  return new Promise((resolve, reject) => {
-    compiler.run((runError, stats) => {
-      compiler.close((closeError) => {
-        if (runError || closeError) {
-          reject(runError || closeError);
-        } else {
-          resolve(stats);
-        }
-      });
-    });
-  });
-}
-
-function installMissingLoaderFallbacks(fallbacks) {
-  const originalResolveFilename = Module._resolveFilename;
-  const missingFallbacks = new Map();
-
-  for (const [request, fallback] of Object.entries(fallbacks)) {
-    try {
-      originalResolveFilename.call(Module, request, module, false);
-    } catch (error) {
-      missingFallbacks.set(request, fallback);
-    }
-  }
-
-  Module._resolveFilename = function resolveFilename(request, parent, isMain, options) {
-    if (missingFallbacks.has(request)) {
-      return missingFallbacks.get(request);
-    }
-    return originalResolveFilename.call(this, request, parent, isMain, options);
-  };
-
-  return () => {
-    Module._resolveFilename = originalResolveFilename;
-  };
-}
-
-function createAssetLoaderFallbacks(project) {
-  const fileLoader = project.write(
-    'test-file-loader.js',
-    [
-      "const path = require('path');",
-      'module.exports = function loader(content) {',
-      "  const name = path.relative(this.rootContext, this.resourcePath).replace(/\\\\/g, '/');",
-      '  this.emitFile(name, content);',
-      '  return `module.exports = ${JSON.stringify(name)};`;',
-      '};',
-      'module.exports.raw = true;',
-    ].join('\n'),
-  );
-  const urlLoader = project.write(
-    'test-url-loader.js',
-    [
-      "const crypto = require('crypto');",
-      "const path = require('path');",
-      'module.exports = function loader(content) {',
-      "  const hash = crypto.createHash('sha256').update(content).digest('hex').slice(0, 16);",
-      '  const info = path.parse(this.resourcePath);',
-      '  const name = `assets/${info.name}.${hash}${info.ext}`;',
-      '  this.emitFile(name, content);',
-      '  return `module.exports = ${JSON.stringify(name)};`;',
-      '};',
-      'module.exports.raw = true;',
-    ].join('\n'),
-  );
-
-  return { 'file-loader': fileLoader, 'url-loader': urlLoader };
-}
-
-module.exports = {
-  createAssetLoaderFallbacks,
-  installMissingLoaderFallbacks,
-  runCompiler,
-};