微信小程序 + Taro + miniprogram-ci + Less 模块加载兼容踩坑实录

2 阅读2分钟

微信小程序 + Taro + miniprogram-ci + Less 模块加载兼容踩坑实录

Taro 的预览和上传通过 mini-ci 插件调用微信 CI 工具。这个阶段仍运行在 Node.js 中,依赖入口不兼容时,流程会先停在工具加载,而不是小程序页面执行。

miniprogram-ci 加载 Less 时提示找不到 less/lib/less

Taro 4.3.2、miniprogram-ci 1.9.27 与 Less 4.9.1 组合中,Less 公共入口可以解析,CI 使用的内部入口却不能。Node.js 24.15.0 下的模块解析结果为:

less -> dist/less-node.cjs
less/lib/less -> MODULE_NOT_FOUND
less/lib/less/environment/abstract-file-manager.js -> 可解析

这里需要检查的是第二行。仅执行 require('less') 能成功,不足以说明 miniprogram-ci 可以正常加载 Less。

小程序 package.json 中的相关命令和版本如下,其他依赖省略:

{
  "scripts": {
    "preview": "taro build --type weapp --preview",
    "upload": "taro build --type weapp --upload"
  },
  "devDependencies": {
    "@tarojs/plugin-mini-ci": "4.3.2",
    "miniprogram-ci": "1.9.27",
    "less": "4.9.1"
  }
}

Taro 配置已注册 @tarojs/plugin-mini-ci。preview、upload 加载 miniprogram-ci 后,其代码分析模块使用了以下入口:

const hn = require('less/lib/less').default,
  dn = require('less/lib/less/environment/abstract-file-manager.js').default,
  fn = require('less/lib/less/environment/abstract-plugin-loader.js').default;

第一条路径省略了 index.js。Less 4.9.1 的 exports 将内部路径按下面的规则导出:

{
  "type": "module",
  "exports": {
    ".": {
      "browser": "./dist/less.cjs",
      "import": "./lib/less-node/index.js",
      "require": "./dist/less-node.cjs",
      "default": "./lib/less-node/index.js"
    },
    "./lib/*": "./lib/*"
  }
}

less/lib/less 对应的目标是 ./lib/less。通过 exports 解析时,Node.js 不会继续按旧的目录规则补上 index.js。目录中的文件仍存在,原来的无后缀入口却不能继续加载,因此得到 MODULE_NOT_FOUND。

这与访问未导出路径时的 ERR_PACKAGE_PATH_NOT_EXPORTED 不同,也不是微信基础库或 Less 语法问题。miniprogram-ci 声明 less: '^4.1.2',允许安装到 4.9.1,但内部代码仍依赖旧入口。Taro CI 插件文档介绍了这套工具的调用方式。

保留现有 CI 版本时,可以将 Less 调整为能解析该入口的 4.2.0。先修改小程序 package.json:

{
  "devDependencies": {
    "less": "4.2.0",
    "miniprogram-ci": "1.9.27"
  }
}

再在工作区根目录 pnpm-workspace.yaml 中定向覆盖:

overrides:
  'miniprogram-ci>less': 4.2.0

直接依赖控制应用的 Less,覆盖规则控制 miniprogram-ci 使用的 Less,不需要让其他消费者一起降级。重新安装后,从 CI 包的位置检查实际入口:

pnpm install
pnpm --filter miniprogram why less
node --input-type=commonjs <<'NODE'
const path = require('node:path');
const { createRequire } = require('node:module');
const appRequire = createRequire(path.resolve('apps/miniprogram/package.json'));
const ciRequire = createRequire(appRequire.resolve('miniprogram-ci/package.json'));
console.log(ciRequire('less/package.json').version);
console.log(ciRequire.resolve('less/lib/less'));
NODE

apps/miniprogram/package.json 表示小程序子包的位置,miniprogram 表示包名,均按实际结构替换。结果应为 4.2.0,入口落到 less/lib/less/index.js。工作区配置和锁文件一起提交。

这项检查只覆盖模块加载。完整预览还依赖 appid、上传密钥与权限,需在相应环境继续验证。4.2.0 也不是已穷举后的唯一版本;升级 miniprogram-ci 后,应重新检查它是否仍使用这些内部路径。