微信小程序 + 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 后,应重新检查它是否仍使用这些内部路径。