@tmsfe/tmskit 0.0.37 → 0.0.38

package/dist/index.cjs.js

@@ -9,25 +9,27 @@ var require$$0$2 = require('shelljs');
 var require$$4 = require('glob-ignore');
 var require$$1$2 = require('os');
 var require$$0$3 = require('lodash');
+var require$$1$3 = require('preprocess');
+var require$$4$1 = require('json5');
 var require$$0$4 = require('async');
-var require$$1$3 = require('ejs');
-var require$$1$4 = require('inquirer');
+var require$$1$4 = require('ejs');
+var require$$1$5 = require('inquirer');
 var require$$0$5 = require('metalsmith');
 var require$$0$6 = require('request');
 var require$$10 = require('unzipper');
-var require$$1$5 = require('crypto');
+var require$$1$6 = require('crypto');
 var require$$0$7 = require('miniprogram-ci');
-var require$$1$6 = require('fs-extra');
-var require$$1$7 = require('semver');
-var require$$0$8 = require('gulp');
+var require$$1$7 = require('fs-extra');
+var require$$1$8 = require('semver');
+var require$$0$8 = require('through2');
+var require$$0$9 = require('gulp');
 var require$$2 = require('minimatch');
 var require$$3$1 = require('gulp-if');
-var require$$6 = require('through2');
-var require$$0$9 = require('object-assign');
+var require$$0$a = require('object-assign');
 var require$$3$2 = require('fancy-log');
-var require$$4$1 = require('ansi-colors');
+var require$$4$2 = require('ansi-colors');
 var require$$5 = require('chokidar');
-var require$$6$1 = require('readable-stream');
+var require$$6 = require('readable-stream');
 var require$$7 = require('vinyl-file');
 var require$$8 = require('vinyl');
 var require$$9 = require('anymatch');
@@ -35,7 +37,7 @@ var require$$11 = require('glob-parent');
 var require$$2$1 = require('plugin-error');
 var require$$10$1 = require('path-is-absolute');
 var require$$12$1 = require('slash');
-var require$$1$8 = require('commander');
+var require$$1$9 = require('commander');
 
 function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e["default"] : e; }
 
@@ -48,25 +50,27 @@ var require$$0__default$2 = /*#__PURE__*/_interopDefaultLegacy(require$$0$2);
 var require$$4__default = /*#__PURE__*/_interopDefaultLegacy(require$$4);
 var require$$1__default$2 = /*#__PURE__*/_interopDefaultLegacy(require$$1$2);
 var require$$0__default$3 = /*#__PURE__*/_interopDefaultLegacy(require$$0$3);
-var require$$0__default$4 = /*#__PURE__*/_interopDefaultLegacy(require$$0$4);
 var require$$1__default$3 = /*#__PURE__*/_interopDefaultLegacy(require$$1$3);
+var require$$4__default$1 = /*#__PURE__*/_interopDefaultLegacy(require$$4$1);
+var require$$0__default$4 = /*#__PURE__*/_interopDefaultLegacy(require$$0$4);
 var require$$1__default$4 = /*#__PURE__*/_interopDefaultLegacy(require$$1$4);
+var require$$1__default$5 = /*#__PURE__*/_interopDefaultLegacy(require$$1$5);
 var require$$0__default$5 = /*#__PURE__*/_interopDefaultLegacy(require$$0$5);
 var require$$0__default$6 = /*#__PURE__*/_interopDefaultLegacy(require$$0$6);
 var require$$10__default = /*#__PURE__*/_interopDefaultLegacy(require$$10);
-var require$$1__default$5 = /*#__PURE__*/_interopDefaultLegacy(require$$1$5);
-var require$$0__default$7 = /*#__PURE__*/_interopDefaultLegacy(require$$0$7);
 var require$$1__default$6 = /*#__PURE__*/_interopDefaultLegacy(require$$1$6);
+var require$$0__default$7 = /*#__PURE__*/_interopDefaultLegacy(require$$0$7);
 var require$$1__default$7 = /*#__PURE__*/_interopDefaultLegacy(require$$1$7);
+var require$$1__default$8 = /*#__PURE__*/_interopDefaultLegacy(require$$1$8);
 var require$$0__default$8 = /*#__PURE__*/_interopDefaultLegacy(require$$0$8);
+var require$$0__default$9 = /*#__PURE__*/_interopDefaultLegacy(require$$0$9);
 var require$$2__default = /*#__PURE__*/_interopDefaultLegacy(require$$2);
 var require$$3__default$1 = /*#__PURE__*/_interopDefaultLegacy(require$$3$1);
-var require$$6__default = /*#__PURE__*/_interopDefaultLegacy(require$$6);
-var require$$0__default$9 = /*#__PURE__*/_interopDefaultLegacy(require$$0$9);
+var require$$0__default$a = /*#__PURE__*/_interopDefaultLegacy(require$$0$a);
 var require$$3__default$2 = /*#__PURE__*/_interopDefaultLegacy(require$$3$2);
-var require$$4__default$1 = /*#__PURE__*/_interopDefaultLegacy(require$$4$1);
+var require$$4__default$2 = /*#__PURE__*/_interopDefaultLegacy(require$$4$2);
 var require$$5__default = /*#__PURE__*/_interopDefaultLegacy(require$$5);
-var require$$6__default$1 = /*#__PURE__*/_interopDefaultLegacy(require$$6$1);
+var require$$6__default = /*#__PURE__*/_interopDefaultLegacy(require$$6);
 var require$$7__default = /*#__PURE__*/_interopDefaultLegacy(require$$7);
 var require$$8__default = /*#__PURE__*/_interopDefaultLegacy(require$$8);
 var require$$9__default = /*#__PURE__*/_interopDefaultLegacy(require$$9);
@@ -74,11 +78,11 @@ var require$$11__default = /*#__PURE__*/_interopDefaultLegacy(require$$11);
 var require$$2__default$1 = /*#__PURE__*/_interopDefaultLegacy(require$$2$1);
 var require$$10__default$1 = /*#__PURE__*/_interopDefaultLegacy(require$$10$1);
 var require$$12__default = /*#__PURE__*/_interopDefaultLegacy(require$$12$1);
-var require$$1__default$8 = /*#__PURE__*/_interopDefaultLegacy(require$$1$8);
+var require$$1__default$9 = /*#__PURE__*/_interopDefaultLegacy(require$$1$9);
 
 var src$3 = {};
 
-const chalk$4 = require$$3__default;
+const chalk$5 = require$$3__default;
 const moment$1 = require$$1__default;
 
 /**
@@ -114,7 +118,7 @@ const succeed$2 = (message = '') => {
  * @returns {undefined} 无
  */
 const warn$2 = message => {
-  console.log(`${moment$1().format('YYYY-MM-DD HH:mm:ss')}`, chalk$4.yellow(message));
+  console.log(`${moment$1().format('YYYY-MM-DD HH:mm:ss')}`, chalk$5.yellow(message));
 };
 const info$j = (...args) => console.log(`${moment$1().format('YYYY-MM-DD HH:mm:ss')}`, ...args);
 const infoNoTime$1 = (...args) => console.log(...args);
@@ -127,7 +131,7 @@ var log$1 = {
 };
 
 const ora$2 = require$$0__default;
-const path$g = require$$1__default$1;
+const path$h = require$$1__default$1;
 const fs$j = require$$0__default$1;
 const shelljs$7 = require$$0__default$2;
 const glob = require$$4__default;
@@ -142,7 +146,7 @@ const shelljsOptions = {
 // 获取当前目录
 const cwd = process.cwd();
 function resolve$j(...args) {
-  return path$g.resolve(cwd, ...args);
+  return path$h.resolve(cwd, ...args);
 }
 
 /**
@@ -175,7 +179,7 @@ function downloadRepoForGit$1(url, dest, branch) {
   return new Promise((resolve, reject) => {
     // 如果目标目录不存在
     if (fs$j.existsSync(dest)) {
-      shelljs$7.rm('-rf', path$g.join(dest));
+      shelljs$7.rm('-rf', path$h.join(dest));
     }
     shelljs$7.mkdir('-p', dest);
     shelljs$7.cd(dest);
@@ -296,7 +300,7 @@ const mergeMap$1 = function (obj, src) {
   return obj;
 };
 const relativeCwdPath$1 = function (file) {
-  return path$g.relative(process.cwd(), file);
+  return path$h.relative(process.cwd(), file);
 };
 
 /**
@@ -383,35 +387,35 @@ var widgets = {
 
 var tmsMpconfig = {exports: {}};
 
-const path$f = require$$1__default$1;
+const path$g = require$$1__default$1;
 const os = require$$1__default$2;
 
 // 用户目录
 const HOME_DIR = os.homedir();
 
 // 所有文件的缓存目录
-const CACHE_DIR = path$f.resolve(HOME_DIR, '.tmskit');
+const CACHE_DIR = path$g.resolve(HOME_DIR, '.tmskit');
 
 // 版本管理的CDN地址
 const VERSION_URL = 'https://tms-web-1g1czzwka2fd06f2-1301126013.tcloudbaseapp.com/tmskit-template/version.json';
 
 // version缓存文件
-const VERSION_CACHE_FILE = path$f.resolve(CACHE_DIR, 'version_cache_file.json');
+const VERSION_CACHE_FILE = path$g.resolve(CACHE_DIR, 'version_cache_file.json');
 
 // npm缓存文件
-const NPM_CACHE_FILE$1 = path$f.resolve(CACHE_DIR, 'npm_cache_file.json');
+const NPM_CACHE_FILE$1 = path$g.resolve(CACHE_DIR, 'npm_cache_file.json');
 
 // 脚手架模板代码所在目录
-const TEMPLATE_DIR$1 = path$f.resolve(CACHE_DIR, 'template');
+const TEMPLATE_DIR$1 = path$g.resolve(CACHE_DIR, 'template');
 
 // 第三方模块源码存放的临时缓存目录
-const MODULE_CODE_DIR$2 = path$f.resolve(CACHE_DIR, 'modules_code');
+const MODULE_CODE_DIR$2 = path$g.resolve(CACHE_DIR, 'modules_code');
 
 // 缓存分包node_modules的目录
-const NODE_MODULES_DIR$2 = path$f.resolve(CACHE_DIR, 'node_modules');
+const NODE_MODULES_DIR$2 = path$g.resolve(CACHE_DIR, 'node_modules');
 
 // 扩展命令源码的存放处
-const EXTEND_CMD$1 = path$f.resolve(CACHE_DIR, 'cmd');
+const EXTEND_CMD$1 = path$g.resolve(CACHE_DIR, 'cmd');
 
 // 创建模板的名称
 const TEMPLATE_NAME$1 = 'tmskit-template';
@@ -437,7 +441,7 @@ const MODULE_CONFIG_FILENAME = 'module.config.json';
 
 // 默认的webpack entry
 const DEFAULT_WEBPACK_ENTRY = {
-  app: path$f.resolve(process.cwd(), 'app')
+  app: path$g.resolve(process.cwd(), 'app')
 };
 
 // 默认从源码拷贝到编译后的配置
@@ -544,6 +548,8 @@ var defaultTmsConfig = {
   const loadash = require$$0__default$3;
   const fs = require$$0__default$1;
   const path = require$$1__default$1;
+  const pp = require$$1__default$3;
+  const JSON5 = require$$4__default$1;
   const {
     TMS_CONFIG_FILENAME,
     MODULE_CONFIG_FILENAME,
@@ -604,9 +610,18 @@ var defaultTmsConfig = {
       modules.all = tmsConfig.modules;
       tmsConfig.modules = modules;
     }
-    // 合并默认值
-    const res = loadash.mergeWith(tmsConfig, tmsPrivateCf, (objValue, srcValue) => {
-      if (loadash.isArray(objValue) && objValue[0] && loadash.isObject(objValue[0])) {
+    // 使用自定义的合并策略：
+    // 1. 对 templateVars 字段做浅合并（即把 tms.config.js 中的和 tms.private.config.js 中的对象合并，
+    //    如果存在同名字段则以 tms.private.config.js 中的为准）。
+    // 2. 对数组（并且数组元素为对象的情况）执行拼接
+    const res = loadash.mergeWith({}, tmsConfig, tmsPrivateCf, (objValue, srcValue, key) => {
+      if (key === 'templateVars') {
+        return {
+          ...(objValue || {}),
+          ...(srcValue || {})
+        };
+      }
+      if (Array.isArray(objValue) && objValue[0] && isObject(objValue[0])) {
         return objValue.concat(srcValue);
       }
     });
@@ -674,13 +689,20 @@ var defaultTmsConfig = {
    * @param {array} modules 用户要编译的模块列表
    * @param { string } appName 小程序的名称
    */
-  function getModulesConfig(modules = [], appName) {
+  function getModulesConfig(modules = [], tmsConfig) {
+    const {
+      appName
+    } = tmsConfig;
     const modulesConfig = [];
     modules.forEach(moduleItem => {
       const moduleConfigPath = resolve(moduleItem.path, MODULE_CONFIG_FILENAME);
       let moduleConfig;
       try {
-        moduleConfig = JSON.parse(fs.readFileSync(moduleConfigPath, 'utf-8'));
+        // 模板渲染：先将 module.config.json 转为字符串，然后通过 preprocess 渲染
+        const moduleConfigJsonStr = fs.readFileSync(moduleConfigPath, 'utf-8');
+        const preprocessedStr = pp.preprocess(moduleConfigJsonStr, tmsConfig.templateVars || {}, 'json');
+        // fs.writeFileSync(resolve(moduleConfigPath), moduleConfigJsonStr, 'utf8');
+        moduleConfig = JSON5.parse(preprocessedStr);
       } catch (e) {
         throw new Error(`${moduleConfigPath}json解析报错: ${e}`);
       }
@@ -785,11 +807,11 @@ var defaultTmsConfig = {
             allModules.set(moduleItem.moduleName, moduleItem);
           }
           if (errorIsQuit) {
-            throw new Error(`${moduleItem.moduleName}模块的配置文件module.config.json在${moduleItem.path}目录下没有找到`);
+            throw new Error(`${moduleItem.moduleName}模块的配置文件module.config.json在${moduleItem.path}目录下没有找到 ${moduleConfigPath}`);
           }
           return;
         }
-        const [moduleConfig = {}] = getModulesConfig([moduleItem], tmsConfig.appName);
+        const [moduleConfig = {}] = getModulesConfig([moduleItem], tmsConfig);
         if (!allModules.has(moduleItem.moduleName)) {
           allModules.set(moduleItem.moduleName, checkModuleItem(tmsConfig, moduleItem, moduleConfig));
           const dependenciesModules = getModulesByModuleNames(tmsConfig, moduleConfig === null || moduleConfig === void 0 ? void 0 : moduleConfig.dependencies);
@@ -818,7 +840,7 @@ var defaultTmsConfig = {
 })(tmsMpconfig);
 
 const fs$i = require$$0__default$1;
-const path$e = require$$1__default$1;
+const path$f = require$$1__default$1;
 const {
   info: info$h
 } = log$1;
@@ -859,7 +881,7 @@ const copyFile = function (src, dest) {
   if (fs$i.existsSync(dest)) {
     fs$i.unlinkSync(dest);
   }
-  const dir = path$e.dirname(dest);
+  const dir = path$f.dirname(dest);
   ensureDirExist$6(dir);
   fs$i.copyFileSync(src, dest);
 };
@@ -913,7 +935,7 @@ const fileInDir = (dir, file) => {
   if (!fs$i.existsSync(dir) || !fs$i.existsSync(file)) {
     return false;
   }
-  const relativePath = path$e.relative(dir, file);
+  const relativePath = path$f.relative(dir, file);
   if (relativePath.startsWith('..')) {
     return false;
   }
@@ -924,7 +946,7 @@ function findAllFilesOfDir(dir) {
   function listFile(dir) {
     const arr = fs$i.readdirSync(dir);
     arr.forEach(item => {
-      const fullPath = path$e.join(dir, item);
+      const fullPath = path$f.join(dir, item);
       const stats = fs$i.statSync(fullPath);
       if (stats.isDirectory()) {
         listFile(fullPath);
@@ -949,7 +971,7 @@ var io$3 = {
 };
 
 const async = require$$0__default$4;
-const ejs = require$$1__default$3;
+const ejs = require$$1__default$4;
 const render$1 = (files, metalsmith, next) => {
   const keys = Object.keys(files);
   const metadata = metalsmith.metadata();
@@ -965,7 +987,7 @@ const render$1 = (files, metalsmith, next) => {
 var render_1 = render$1;
 
 const fs$h = require$$0__default$1;
-const inquirer$1 = require$$1__default$4;
+const inquirer$1 = require$$1__default$5;
 const {
   resolve: resolve$i
 } = widgets;
@@ -1076,10 +1098,10 @@ const report$a = (name, attrs = {}) => {
 };
 var report_1 = report$a;
 
-const path$d = require$$1__default$1;
+const path$e = require$$1__default$1;
 const fs$g = require$$0__default$1;
 const shelljs$6 = require$$0__default$2;
-const inquirer = require$$1__default$4;
+const inquirer = require$$1__default$5;
 const {
   TEMPLATE_DIR,
   TEMPLATE_URL,
@@ -1154,7 +1176,7 @@ function downloadAndUnZipTemplate(templateDir, templateUrl, templateName) {
  */
 async function create(projectName) {
   const cwd = process.cwd();
-  const targetDir = path$d.resolve(cwd, projectName);
+  const targetDir = path$e.resolve(cwd, projectName);
   const {
     projectType
   } = await inquirer.prompt(CREATE_TEMPLATE_QUESTION);
@@ -1177,7 +1199,7 @@ async function create(projectName) {
   await downloadAndUnZipTemplate(TEMPLATE_DIR, TEMPLATE_URL, TEMPLATE_NAME);
 
   // 生成模板(1. 询问问题， 2. ejs生成模板  3.生成到目标目录)
-  generator(path$d.join(TEMPLATE_DIR, TEMPLATE_NAME, projectType), targetDir).then(() => {
+  generator(path$e.join(TEMPLATE_DIR, TEMPLATE_NAME, projectType), targetDir).then(() => {
     shelljs$6.cd(projectName);
     const hookFilePath = resolve$h(projectName, TEMPLATE_TKIT_DIR, 'hooks.js');
     if (fs$g.existsSync(hookFilePath)) {
@@ -1207,7 +1229,7 @@ async function create(projectName) {
 var create_1 = create;
 
 const fs$f = require$$0__default$1;
-const path$c = require$$1__default$1;
+const path$d = require$$1__default$1;
 const shellJs$3 = require$$0__default$2;
 const {
   ensureDirExist: ensureDirExist$5
@@ -1272,7 +1294,7 @@ function loadExtendCmd$1() {
     Object.keys(deps).forEach(name => {
       // 检索cmd的npm包
       if (!/^tmskit-cmd-|^@[^/]+\/tmskit-cmd-/.test(name)) return false;
-      const cmdConfig = path$c.join(cmdNpmDir, name, 'tms.config.js');
+      const cmdConfig = path$d.join(cmdNpmDir, name, 'tms.config.js');
       if (fs$f.existsSync(cmdConfig)) {
         cmdConfigs.push(cmdConfig);
       }
@@ -1338,6 +1360,7 @@ var handleError_1 = {
 
 /* eslint-disable no-param-reassign */
 const fs$e = require$$0__default$1;
+const pp$1 = require$$1__default$3;
 const {
   getSubPackages: getSubPackages$3,
   getModulesConfig
@@ -1366,7 +1389,7 @@ const report$8 = report_1;
  */
 function updateMainPackages(appJson, mainPackages = []) {
   let foundMainPackages = appJson.subpackages.filter(subpackage => mainPackages.includes(subpackage.name));
-  if (foundMainPackages.length === 0) {
+  if (foundMainPackages.length === 0 && appJson.pages.length === 0) {
     // 没找到主包
     foundMainPackages = [appJson.subpackages[0]];
   }
@@ -1401,8 +1424,8 @@ const getAppJsonContent = sourceAppJsonPath => {
   }
   const appJson = JSON.parse(fs$e.readFileSync(sourceAppJsonPath), 'utf-8');
   // 加入默认值
-  appJson.subpackages = [];
-  appJson.pages = [];
+  appJson.subpackages = appJson.subpackages || [];
+  appJson.pages = appJson.pages || [];
   return appJson;
 };
 
@@ -1462,15 +1485,15 @@ const fixAppJson = appJson => {
  * @param {array} modules 用户要编译的模块列表
  * @returns
  */
-async function buildOutputAppJson$2(tmsConfig, modules) {
+async function buildOutputAppJson$3(tmsConfig, modules) {
   try {
     var _tmsConfig$hooks;
     // 获取所有模块，合并模块依赖的模块
-    const modulesConfig = getModulesConfig(modules, tmsConfig.appName, false);
+    const modulesConfig = getModulesConfig(modules, tmsConfig, false);
     // 获取所有的分包
     const subPackages = getSubPackages$3(modulesConfig);
     // 获取app.json的配置
-    const appJson = getAppJsonContent(resolve$g('./app.json'));
+    let appJson = getAppJsonContent(resolve$g('./app.json'));
 
     // 更新app.json中的subpackages
     appJson.subpackages = subPackages;
@@ -1480,7 +1503,12 @@ async function buildOutputAppJson$2(tmsConfig, modules) {
     fixAppJson(appJson);
     // 更新主包，需在subpackages处理完成后执行， pages/
     updateMainPackages(appJson, tmsConfig.mainPackages);
-    fs$e.writeFileSync(resolve$g(`${tmsConfig.outputDir}/app.json`), JSON.stringify(appJson, null, 2), 'utf8');
+
+    // 模板渲染：先将 app.json 转为字符串，然后通过 preprocess 渲染
+    const appJsonStr = JSON.stringify(appJson, null, 2);
+    const preprocessedStr = pp$1.preprocess(appJsonStr, tmsConfig.templateVars || {}, 'json');
+    fs$e.writeFileSync(resolve$g(`${tmsConfig.outputDir}/app.json`), preprocessedStr, 'utf8');
+    appJson = JSON.parse(preprocessedStr);
     if (typeof (tmsConfig === null || tmsConfig === void 0 ? void 0 : (_tmsConfig$hooks = tmsConfig.hooks) === null || _tmsConfig$hooks === void 0 ? void 0 : _tmsConfig$hooks.updateAppJson) === 'function') {
       var _tmsConfig$hooks2;
       await (tmsConfig === null || tmsConfig === void 0 ? void 0 : (_tmsConfig$hooks2 = tmsConfig.hooks) === null || _tmsConfig$hooks2 === void 0 ? void 0 : _tmsConfig$hooks2.updateAppJson({
@@ -1499,14 +1527,14 @@ async function buildOutputAppJson$2(tmsConfig, modules) {
   }
 }
 var buildAppJson = {
-  buildOutputAppJson: buildOutputAppJson$2
+  buildOutputAppJson: buildOutputAppJson$3
 };
 
 /**
  * 下载第三方代码
  */
 const MetalSmith = require$$0__default$5;
-const crypto$2 = require$$1__default$5;
+const crypto$2 = require$$1__default$6;
 const {
   downloadRepoForGit,
   pullRepoForGit,
@@ -1739,7 +1767,7 @@ var cloneModules_1 = {
 };
 
 const ci = require$$0__default$7;
-const path$b = require$$1__default$1;
+const path$c = require$$1__default$1;
 
 /**
  * 获取小程序ci的Project对象
@@ -1752,7 +1780,7 @@ const getMpCi = ({
   privateKey = 'TODO'
 }) => {
   var _projectCg$packOption, _projectCg$packOption2;
-  const projectCg = require(path$b.join(projectPath, 'project.config.json'));
+  const projectCg = require(path$c.join(projectPath, 'project.config.json'));
   const ignores = (projectCg === null || projectCg === void 0 ? void 0 : (_projectCg$packOption = projectCg.packOptions) === null || _projectCg$packOption === void 0 ? void 0 : (_projectCg$packOption2 = _projectCg$packOption.ignore) === null || _projectCg$packOption2 === void 0 ? void 0 : _projectCg$packOption2.map(({
     value
   }) => value)) || [];
@@ -1871,7 +1899,7 @@ var mpCi$2 = {
 };
 
 const fs$c = require$$0__default$1;
-const path$a = require$$1__default$1;
+const path$b = require$$1__default$1;
 const {
   NPM_CACHE_FILE
 } = constant;
@@ -1890,7 +1918,7 @@ function getCache$1(projectDir, type) {
 function setCache$1(projectDir, type = 'miniprogram_npm', data) {
   const filePath = NPM_CACHE_FILE;
   if (!fs$c.existsSync(filePath)) {
-    const dir = path$a.dirname(filePath);
+    const dir = path$b.dirname(filePath);
     ensureDirExist$4(dir);
     fs$c.writeFileSync(filePath, '{}');
   }
@@ -1912,9 +1940,9 @@ var cache = {
  * 本文件主要负责项目或者分包依赖的npm的安装
  */
 const fs$b = require$$0__default$1;
-const fsExtra = require$$1__default$6;
-const crypto$1 = require$$1__default$5;
-const path$9 = require$$1__default$1;
+const fsExtra = require$$1__default$7;
+const crypto$1 = require$$1__default$6;
+const path$a = require$$1__default$1;
 const shell = require$$0__default$2;
 const log = log$1;
 const {
@@ -1959,15 +1987,15 @@ const collectNpmTasksMap = (packageJsonFiles, cacheDir) => {
     };
     if (Object.keys(md5Obj.dependencies).length !== 0) {
       const md5Key = crypto$1.createHash('md5').update(JSON.stringify(md5Obj)).digest('hex');
-      const cacheNMPath = path$9.join(cacheDir, md5Key);
-      const cacheNMTarFile = path$9.join(cacheNMPath, 'node_modules.tar.gz');
+      const cacheNMPath = path$a.join(cacheDir, md5Key);
+      const cacheNMTarFile = path$a.join(cacheNMPath, 'node_modules.tar.gz');
 
       // 下载后，添加回调函数 (拷贝node_modules.tar.gz到编译目录并解压)
       const callback = {
         params: {
           cacheNMPath,
           cacheNMTarFile,
-          packageJsonDir: path$9.dirname(packageJsonPath),
+          packageJsonDir: path$a.dirname(packageJsonPath),
           shell
         },
         fn: async (cacheNMPath, cacheNMTarFile, packageJsonDir, shell) => {
@@ -2080,7 +2108,7 @@ const findFilesByFilter = (startPath, filter) => {
     }
     const files = fs$b.readdirSync(startPath);
     files.forEach(file => {
-      const filename = path$9.join(startPath, file);
+      const filename = path$a.join(startPath, file);
       const stat = fs$b.lstatSync(filename);
       // 当前文件是文件夹类型，继续递归
       if (stat.isDirectory()) {
@@ -2104,10 +2132,10 @@ const findFilesByFilter = (startPath, filter) => {
 const findAllPackageJson = (subRoots = [], contextDir) => {
   const packageJsonName = 'package.json'; // 查找文件名
   const cwd = contextDir || dirPath;
-  const result = [path$9.join(cwd, packageJsonName)]; // 默认填充根目录下的package.json
+  const result = [path$a.join(cwd, packageJsonName)]; // 默认填充根目录下的package.json
 
   subRoots.forEach(subRoot => {
-    const toppath = path$9.join(cwd, subRoot.root); // 从该目录开始查找package.json文件
+    const toppath = path$a.join(cwd, subRoot.root); // 从该目录开始查找package.json文件
     const list = findFilesByFilter(toppath, packageJsonName);
     result.push(...list);
   });
@@ -2119,7 +2147,7 @@ var npm = {
   findFilesByFilter
 };
 
-const crypto = require$$1__default$5;
+const crypto = require$$1__default$6;
 const fs$a = require$$0__default$1;
 function fileMd5$1(filePath) {
   return new Promise((resolve, reject) => {
@@ -2142,12 +2170,12 @@ var md5 = {
 };
 
 const fs$9 = require$$0__default$1;
-const semver$1 = require$$1__default$7;
+const semver$1 = require$$1__default$8;
 const {
   resolve: resolve$e,
   getAbsolutePath: getAbsolutePath$5
 } = widgets;
-const path$8 = require$$1__default$1;
+const path$9 = require$$1__default$1;
 const shelljs$4 = require$$0__default$2;
 const {
   handleError: handleError$4
@@ -2165,7 +2193,7 @@ function collectPackageJson(subPackages, cwd, outputDir) {
   const packageJsonName = 'package.json'; // 查找文件名
   // 1.1根目录的package.json
   const packageArr = [{
-    srcPackageDir: path$8.join(cwd, packageJsonName),
+    srcPackageDir: path$9.join(cwd, packageJsonName),
     destNpmDir: resolve$e(outputDir, 'node_modules')
   }];
   // 1.2模块的package.json
@@ -2214,11 +2242,11 @@ const checkPackageVersion$1 = packageArr => {
     const dependencies = readPackageDependencies(item.srcPackageDir);
     const dependenciesKeys = Object.keys(dependencies);
     for (const key of dependenciesKeys) {
-      const depPath = path$8.join(item.destNpmDir, key);
+      const depPath = path$9.join(item.destNpmDir, key);
       if (!fs$9.existsSync(depPath)) {
         return true;
       }
-      const depPackagePath = path$8.join(depPath, 'package.json');
+      const depPackagePath = path$9.join(depPath, 'package.json');
       if (fs$9.existsSync(depPackagePath)) {
         const packageData = require(depPackagePath);
         if (dependencies[key] === 'latest') {
@@ -2242,7 +2270,7 @@ var checkDependencies = {
 
 const shelljs$3 = require$$0__default$2;
 const fs$8 = require$$0__default$1;
-const path$7 = require$$1__default$1;
+const path$8 = require$$1__default$1;
 const io$1 = io$3;
 const {
   createTask: createTask$4,
@@ -2342,7 +2370,7 @@ async function mpCiInstall(tmsConfig, subPackages, useCache) {
   if (useCache) {
     let flag = true;
     await Promise.all(packageJsonFiles.map(async item => {
-      const packageDir = path$7.dirname(item);
+      const packageDir = path$8.dirname(item);
       const mpDir = resolve$d(`${packageDir}/miniprogram_npm`);
       const md5Value = await getMNPMd5(packageDir);
       const preCache = getCache(mpDir, 'miniprogram_npm');
@@ -2361,7 +2389,7 @@ async function mpCiInstall(tmsConfig, subPackages, useCache) {
 
   // 即将构建，在cache中标记开始
   await Promise.all(packageJsonFiles.map(async item => {
-    const packageDir = path$7.dirname(item);
+    const packageDir = path$8.dirname(item);
     const mpDir = resolve$d(`${packageDir}/miniprogram_npm`);
     setCache(mpDir, 'miniprogram_npm', {
       md5: '',
@@ -2376,7 +2404,7 @@ async function mpCiInstall(tmsConfig, subPackages, useCache) {
 
   // 构建成功后，计算md5写入cache
   await Promise.all(packageJsonFiles.map(async item => {
-    const packageDir = path$7.dirname(item);
+    const packageDir = path$8.dirname(item);
     const mpDir = resolve$d(`${packageDir}/miniprogram_npm`);
     const md5Value = await getMNPMd5(packageDir);
     setCache(mpDir, 'miniprogram_npm', {
@@ -2398,7 +2426,7 @@ async function getMNPMd5(cwd) {
       cwd,
       ...shellJsOption
     });
-    const tarDir = path$7.join(cwd, './miniprogram_npm.tar.gz');
+    const tarDir = path$8.join(cwd, './miniprogram_npm.tar.gz');
     const md5Value = await fileMd5(tarDir);
     shelljs$3.rm('-rf', tarDir);
     return md5Value;
@@ -2415,7 +2443,7 @@ const {
   createTask: createTask$3
 } = widgets;
 const {
-  buildOutputAppJson: buildOutputAppJson$1
+  buildOutputAppJson: buildOutputAppJson$2
 } = buildAppJson;
 const {
   MODULE_CODE_DIR: MODULE_CODE_DIR$1,
@@ -2466,7 +2494,7 @@ async function task(tmsConfig, targetModules) {
   await install$2(tmsConfig, newSubPackages, true);
 
   // 动态生成编译后的app.json;
-  await createTask$3(buildOutputAppJson$1, '开始生成编译后的app.json', '生成编译后的app.json完成')(tmsConfig, newModules);
+  await createTask$3(buildOutputAppJson$2, '开始生成编译后的app.json', '生成编译后的app.json完成')(tmsConfig, newModules);
   return {
     modules: newModules,
     subPackages: newSubPackages
@@ -2501,10 +2529,105 @@ function mpProjectJson$1() {
 }
 var mpProjectJson_1 = mpProjectJson$1;
 
+/* eslint-disable @typescript-eslint/no-require-imports */
+const through$1 = require$$0__default$8;
+const pp = require$$1__default$3;
+const path$7 = require$$1__default$1;
+const chalk$4 = require$$3__default;
+/* eslint-enable @typescript-eslint/no-require-imports */
+
+// 允许渲染的文件类型列表
+const TEMPLATE_FILE_EXTENSIONS = ['.json', '.js', '.ts', '.wxml', '.wxss', '.wxs', '.css', '.less', '.scss'];
+
+/**
+ * 获取预处理器类型
+ * @param {string} extName 文件扩展名
+ * @returns {string} 预处理器类型
+ */
+const getPreprocessType = extName => {
+  const type = extName.replace('.', '');
+  if (type === 'wxml') return 'html';
+  if (type === 'wxs') return 'js';
+  if (type === 'wxss') return 'css';
+  return type;
+};
+
+/**
+ * 获取错误上下文信息
+ * @param {string} content 文件内容
+ * @param {number} errorLine 错误行号
+ * @param {number} contextLines 上下文行数
+ * @returns {string} 格式化的错误上下文
+ */
+const getErrorContext = (content, errorLine, contextLines = 2) => {
+  const lines = content.split('\n');
+  const start = Math.max(1, errorLine - contextLines);
+  const end = Math.min(lines.length, errorLine + contextLines);
+  let context = '';
+  for (let i = start; i <= end; i++) {
+    const marker = i === errorLine ? ' >> ' : '    ';
+    context += `${marker}${i}| ${lines[i - 1]}\n`;
+  }
+  return context;
+};
+
+/**
+ * 打印错误信息
+ * @param {string} filePath 文件路径
+ * @param {string} context 错误上下文
+ * @param {Error} error 错误对象
+ */
+const printError = (filePath, context, error) => {
+  console.error(`${chalk$4.yellow('渲染模板出错，请检查处理:')}\n${chalk$4.yellow('文件:')}\n${chalk$4.yellow(filePath)}\n${chalk$4.yellow('错误位置:')}\n${chalk$4.gray(context)}\n${chalk$4.red('错误信息:')}\n${chalk$4.red(error.message)}\n${chalk$4.gray('--------------------------------')}`);
+};
+
+/**
+ * 模板渲染插件
+ * @param {Object} tmsConfig 配置对象
+ * @returns {Object} through2 转换流
+ */
+var tmsTemplateRender = function tmsTemplateRender(tmsConfig) {
+  return through$1.obj((file, encoding, callback) => {
+    if (!file.isBuffer()) {
+      return callback(null, file);
+    }
+    const extName = path$7.extname(file.path).toLowerCase();
+    if (!TEMPLATE_FILE_EXTENSIONS.includes(extName)) {
+      return callback(null, file);
+    }
+    const content = file.contents.toString(encoding);
+    try {
+      const vars = tmsConfig.templateVars || {};
+      const ppType = getPreprocessType(extName);
+      // 手动检查 @echo 引用的变量是否存在
+      const echoPattern = /\/\* @echo (\w+) \*\//g;
+      let match;
+      while ((match = echoPattern.exec(content)) !== null) {
+        const variableName = match[1];
+        // eslint-disable-next-line no-prototype-builtins
+        if (!vars.hasOwnProperty(variableName)) {
+          const error = new Error(`变量 ${variableName} 未定义`);
+          error.line = content.substring(0, match.index).split('\n').length;
+          throw error;
+        }
+      }
+      const rendered = pp.preprocess(content, vars, ppType);
+      // eslint-disable-next-line no-param-reassign
+      file.contents = Buffer.from(rendered);
+    } catch (err) {
+      const context = getErrorContext(content, err.line || 1);
+      printError(file.path, context, err);
+      // 直接抛出异常，中断编译流程
+      throw new Error(`模板渲染失败: ${file.path}\n${err.message}`);
+    }
+    callback(null, file);
+  });
+};
+
 const {
   src: src$2,
   dest: dest$1
-} = require$$0__default$8;
+} = require$$0__default$9;
 const path$6 = require$$1__default$1;
 const minimatch = require$$2__default;
 const gulpif = require$$3__default$1;
@@ -2512,7 +2635,7 @@ const mpProjectJson = mpProjectJson_1;
 const {
   resolve: resolve$b
 } = widgets;
-const through = require$$6__default;
+const through = require$$0__default$8;
 const {
   fail: fail$3
 } = log$1;
@@ -2529,7 +2652,7 @@ const addPlugins = function (tmsConfig, srcPipe, pluginParams) {
     glob: '**/project.config.json',
     action: mpProjectJson()
   }, ...plugins];
-  return newPlugins.reduce((srcPipe, pluginItem) => srcPipe.pipe(gulpif(vinyl => minimatch(vinyl.path, pluginItem.glob), through.obj(function (vinyl, enc, next) {
+  return newPlugins.reduce((currentPipe, pluginItem) => currentPipe.pipe(gulpif(vinyl => minimatch(vinyl.path, pluginItem.glob), through.obj(function (vinyl, enc, next) {
     const sourceFile = vinyl.history[0];
     pluginItem.action({
       tmsConfig,
@@ -2558,6 +2681,12 @@ var compile$1 = function (tmsConfig, {
       let srcPipe = src$2(newGlobValue, {
         ...srcOption
       });
+
+      // 在文件读取后，插件处理之前先加入模板渲染插件
+      const templateRender = tmsTemplateRender;
+      srcPipe = srcPipe.pipe(templateRender(tmsConfig));
+
+      // 后续步骤继续执行其他插件
       const pluginParams = {
         module,
         isDev
@@ -2573,15 +2702,15 @@ var compile$1 = function (tmsConfig, {
 
 /* eslint-disable */
 // 该文件源于npm包 gulp-watch 但内部有bug, 故源码进行单独修改
-const assign = require$$0__default$9;
+const assign = require$$0__default$a;
 const path$5 = require$$1__default$1;
 const PluginError = require$$2__default$1;
 const fancyLog = require$$3__default$2;
-const colors = require$$4__default$1;
+const colors = require$$4__default$2;
 const chokidar = require$$5__default;
 const {
   Duplex
-} = require$$6__default$1;
+} = require$$6__default;
 const vinyl = require$$7__default;
 const File = require$$8__default;
 const anymatch = require$$9__default;
@@ -2720,7 +2849,7 @@ const path$4 = require$$1__default$1;
 const shellJs$2 = require$$0__default$2;
 const {
   series: series$2
-} = require$$0__default$8;
+} = require$$0__default$9;
 const {
   info: info$a,
   warn: warn$1,
@@ -2847,7 +2976,7 @@ const chalk$3 = require$$3__default;
 const {
   parallel: parallel$1,
   series: series$1
-} = require$$0__default$8;
+} = require$$0__default$9;
 const {
   resolve: resolve$9,
   mergeMap,
@@ -2855,7 +2984,7 @@ const {
   getAbsolutePath: getAbsolutePath$3
 } = widgets;
 const {
-  buildOutputAppJson
+  buildOutputAppJson: buildOutputAppJson$1
 } = buildAppJson;
 const {
   DEFAULT_COPY_CONFIG
@@ -2921,7 +3050,7 @@ var dev$4 = async (tmsConfig, modules, isDev = true) => {
       // 监听模块配置文件
       watch$1([`${srcModulePath}/**/module.config.json`], {
         events: watchEvents
-      }, () => buildOutputAppJson(tmsConfig, modules, isDev), {
+      }, () => buildOutputAppJson$1(tmsConfig, modules, isDev), {
         from: srcModulePath,
         to: buildModulePath
       });
@@ -2934,8 +3063,10 @@ var dev$4 = async (tmsConfig, modules, isDev = true) => {
       }
       return `!${resolve$9(srcModulePath, newPath)}/**/*`;
     });
+    const moduleConfigPath = `${srcModulePath}/**/module.config.json`;
+    const moduleConfigGlob = tmsConfig.isKeepModuleConfig ? `${moduleConfigPath}` : `!${moduleConfigPath}`;
     mergeMap(compileTasksMap, compile(tmsConfig, {
-      glob: [`${srcModulePath}/**/*`, `!${srcModulePath}/**/module.config.json`, ...excludes],
+      glob: [`${srcModulePath}/**/*`, moduleConfigGlob, ...excludes],
       destPath: buildModulePath,
       module: {
         from: srcModulePath,
@@ -2991,7 +3122,7 @@ var dev$4 = async (tmsConfig, modules, isDev = true) => {
       watch$1([resolve$9('app.json')], {
         ignoreInitial: false,
         events: watchEvents
-      }, async () => await buildOutputAppJson(tmsConfig, modules, isDev), {
+      }, async () => await buildOutputAppJson$1(tmsConfig, modules, isDev), {
         from: resolve$9(),
         to: resolve$9(tmsConfig.outputDir)
       });
@@ -3006,7 +3137,7 @@ var dev$4 = async (tmsConfig, modules, isDev = true) => {
         }, taskFn, module);
       });
     } else {
-      await buildOutputAppJson(tmsConfig, modules, isDev);
+      await buildOutputAppJson$1(tmsConfig, modules, isDev);
     }
     eTime = new Date().getTime() - sTime;
     if (typeof (tmsConfig === null || tmsConfig === void 0 ? void 0 : (_tmsConfig$hooks = tmsConfig.hooks) === null || _tmsConfig$hooks === void 0 ? void 0 : _tmsConfig$hooks.afterFirstCompile) === 'function') {
@@ -3040,6 +3171,9 @@ const {
   filterField: filterField$3
 } = widgets;
 const init$2 = init_1;
+const {
+  buildOutputAppJson
+} = buildAppJson;
 const {
   getModulesByMergeDepModules: getModulesByMergeDepModules$1,
   getSubPackages: getSubPackages$1
@@ -3093,6 +3227,9 @@ async function dev$3(tmsConfig, targetModules) {
     subPackages,
     modules: newModules
   } = await init$2(tmsConfig, targetModules);
+
+  // 在启动开发环境前主动执行生成 app.json
+  await buildOutputAppJson(tmsConfig, newModules);
   info$8('当前dev启动的有效模块', newModules.map(item => item.moduleName).sort());
   if (typeof (tmsConfig === null || tmsConfig === void 0 ? void 0 : (_tmsConfig$hooks = tmsConfig.hooks) === null || _tmsConfig$hooks === void 0 ? void 0 : _tmsConfig$hooks.beforeFirstCompile) === 'function') {
     var _tmsConfig$hooks2;
@@ -3536,7 +3673,7 @@ const {
   dest,
   parallel,
   series
-} = require$$0__default$8;
+} = require$$0__default$9;
 const watch = gulpWatch;
 const {
   info: info$2,
@@ -3903,7 +4040,7 @@ var entry = [{
 
 var require$$12 = {
 	name: "@tmsfe/tmskit",
-	version: "0.0.37",
+	version: "0.0.38",
 	description: "tmskit",
 	main: "dist/index.cjs",
 	bin: {
@@ -3956,6 +4093,8 @@ var require$$12 = {
 		"gulp-watch": "^5.0.1",
 		htmlparser2: "^7.2.0",
 		inquirer: "^7.3.3",
+		json5: "^2.2.3",
+		preprocess: "^3.2.0",
 		leven: "3.1.0",
 		lodash: "^4.17.21",
 		metalsmith: "^2.3.0",
@@ -3988,7 +4127,7 @@ var require$$12 = {
 	}
 };
 
-const semver = require$$1__default$7;
+const semver = require$$1__default$8;
 const packageJson = require$$12;
 const chalk$1 = require$$3__default;
 const {
@@ -4024,7 +4163,7 @@ var check_1 = check$1;
 
 /* eslint-disable no-param-reassign */
 const chalk = require$$3__default;
-const commander = require$$1__default$8;
+const commander = require$$1__default$9;
 const path = require$$1__default$1;
 const fs = require$$0__default$1;
 const {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmsfe/tmskit",
-  "version": "0.0.37",
+  "version": "0.0.38",
   "description": "tmskit",
   "main": "dist/index.cjs",
   "bin": {
@@ -53,6 +53,8 @@
     "gulp-watch": "^5.0.1",
     "htmlparser2": "^7.2.0",
     "inquirer": "^7.3.3",
+    "json5": "^2.2.3",
+    "preprocess": "^3.2.0",
     "leven": "3.1.0",
     "lodash": "^4.17.21",
     "metalsmith": "^2.3.0",

package/src/compile/compile.js

@@ -13,13 +13,13 @@ const getTargetFile = (sourceFile, module, outputDir) => {
   return targetFile;
 };
 
-const addPlugins =  function (tmsConfig, srcPipe, pluginParams) {
+const addPlugins = function (tmsConfig, srcPipe, pluginParams) {
   const { plugins = [] } = tmsConfig;
   const newPlugins = [{
     glob: '**/project.config.json',
     action: mpProjectJson(),
   }, ...plugins];
-  return newPlugins.reduce((srcPipe, pluginItem) => srcPipe.pipe(gulpif(
+  return newPlugins.reduce((currentPipe, pluginItem) => currentPipe.pipe(gulpif(
     vinyl => minimatch(vinyl.path, pluginItem.glob),
     through.obj(function (vinyl, enc, next) {
       const sourceFile = vinyl.history[0];
@@ -55,6 +55,12 @@ module.exports = function (
         const newGlobValue = Array.isArray(sourceFile) ? sourceFile : glob;
         const newDestPath = targetPath ? targetPath : destPath;
         let srcPipe = src(newGlobValue, { ...srcOption });
+
+        // 在文件读取后，插件处理之前先加入模板渲染插件
+        const templateRender = require('./plugins/tmsTemplateRender');
+        srcPipe = srcPipe.pipe(templateRender(tmsConfig));
+
+        // 后续步骤继续执行其他插件
         const pluginParams = { module, isDev };
         srcPipe = addPlugins(tmsConfig, srcPipe, pluginParams);
         return srcPipe

package/src/compile/dev.js

@@ -72,8 +72,12 @@ module.exports = async (tmsConfig, modules, isDev = true) => {
       return `!${resolve(srcModulePath, newPath)}/**/*`;
     });
 
+    const moduleConfigPath = `${srcModulePath}/**/module.config.json`;
+
+    const moduleConfigGlob = tmsConfig.isKeepModuleConfig ? `${moduleConfigPath}` : `!${moduleConfigPath}`;
+
     mergeMap(compileTasksMap, compile(tmsConfig, {
-      glob: [`${srcModulePath}/**/*`, `!${srcModulePath}/**/module.config.json`, ...excludes],
+      glob: [`${srcModulePath}/**/*`, moduleConfigGlob, ...excludes],
       destPath: buildModulePath,
       module: { from: srcModulePath, to: buildModulePath },
       srcOption: { allowEmpty: true },

package/src/compile/plugins/tmsTemplateRender.js

@@ -0,0 +1,122 @@
+/* eslint-disable @typescript-eslint/no-require-imports */
+const through = require('through2');
+const pp = require('preprocess');
+const path = require('path');
+const chalk = require('chalk');
+/* eslint-enable @typescript-eslint/no-require-imports */
+
+// 允许渲染的文件类型列表
+const TEMPLATE_FILE_EXTENSIONS = [
+  '.json',
+  '.js',
+  '.ts',
+  '.wxml',
+  '.wxss',
+  '.wxs',
+  '.css',
+  '.less',
+  '.scss',
+];
+
+/**
+ * 获取预处理器类型
+ * @param {string} extName 文件扩展名
+ * @returns {string} 预处理器类型
+ */
+const getPreprocessType = (extName) => {
+  const type = extName.replace('.', '');
+  if (type === 'wxml') return 'html';
+  if (type === 'wxs') return 'js';
+  if (type === 'wxss') return 'css';
+  return type;
+};
+
+/**
+ * 获取错误上下文信息
+ * @param {string} content 文件内容
+ * @param {number} errorLine 错误行号
+ * @param {number} contextLines 上下文行数
+ * @returns {string} 格式化的错误上下文
+ */
+const getErrorContext = (content, errorLine, contextLines = 2) => {
+  const lines = content.split('\n');
+  const start = Math.max(1, errorLine - contextLines);
+  const end = Math.min(lines.length, errorLine + contextLines);
+
+  let context = '';
+  for (let i = start; i <= end; i++) {
+    const marker = i === errorLine ? ' >> ' : '    ';
+    context += `${marker}${i}| ${lines[i - 1]}\n`;
+  }
+  return context;
+};
+
+/**
+ * 打印错误信息
+ * @param {string} filePath 文件路径
+ * @param {string} context 错误上下文
+ * @param {Error} error 错误对象
+ */
+const printError = (filePath, context, error) => {
+  console.error(`${chalk.yellow('渲染模板出错，请检查处理:')
+  }\n${
+    chalk.yellow('文件:')
+  }\n${
+    chalk.yellow(filePath)
+  }\n${
+    chalk.yellow('错误位置:')
+  }\n${
+    chalk.gray(context)
+  }\n${
+    chalk.red('错误信息:')
+  }\n${
+    chalk.red(error.message)
+  }\n${
+    chalk.gray('--------------------------------')}`);
+};
+
+/**
+ * 模板渲染插件
+ * @param {Object} tmsConfig 配置对象
+ * @returns {Object} through2 转换流
+ */
+module.exports = function tmsTemplateRender(tmsConfig) {
+  return through.obj((file, encoding, callback) => {
+    if (!file.isBuffer()) {
+      return callback(null, file);
+    }
+
+    const extName = path.extname(file.path).toLowerCase();
+    if (!TEMPLATE_FILE_EXTENSIONS.includes(extName)) {
+      return callback(null, file);
+    }
+
+    const content = file.contents.toString(encoding);
+    try {
+      const vars = tmsConfig.templateVars || {};
+      const ppType = getPreprocessType(extName);
+      // 手动检查 @echo 引用的变量是否存在
+      const echoPattern = /\/\* @echo (\w+) \*\//g;
+      let match;
+      while ((match = echoPattern.exec(content)) !== null) {
+        const variableName = match[1];
+        // eslint-disable-next-line no-prototype-builtins
+        if (!vars.hasOwnProperty(variableName)) {
+          const error = new Error(`变量 ${variableName} 未定义`);
+          error.line = content.substring(0, match.index).split('\n').length;
+          throw error;
+        }
+      }
+      const rendered = pp.preprocess(content, vars, ppType);
+      // eslint-disable-next-line no-param-reassign
+      file.contents = Buffer.from(rendered);
+    } catch (err) {
+      const context = getErrorContext(content, err.line || 1);
+      printError(file.path, context, err);
+      // 直接抛出异常，中断编译流程
+      throw new Error(`模板渲染失败: ${file.path}\n${err.message}`);
+    }
+
+    callback(null, file);
+  });
+};

package/src/core/buildAppJson.js

@@ -3,6 +3,7 @@
  */
 /* eslint-disable no-param-reassign */
 const fs = require('fs');
+const pp = require('preprocess');
 const { getSubPackages, getModulesConfig } = require('./tmsMpconfig');
 const { fail, info } = require('../utils/log');
 const { resolve, filterField } = require('../utils/widgets');
@@ -19,7 +20,7 @@ const report = require('../core/report');
  */
 function updateMainPackages(appJson, mainPackages = []) {
   let foundMainPackages = appJson.subpackages.filter(subpackage => mainPackages.includes(subpackage.name));
-  if (foundMainPackages.length === 0) {
+  if (foundMainPackages.length === 0 && appJson.pages.length === 0) {
     // 没找到主包
     foundMainPackages = [appJson.subpackages[0]];
   }
@@ -55,8 +56,8 @@ const getAppJsonContent = (sourceAppJsonPath) => {
   }
   const appJson = JSON.parse(fs.readFileSync(sourceAppJsonPath), 'utf-8');
   // 加入默认值
-  appJson.subpackages = [];
-  appJson.pages = [];
+  appJson.subpackages = appJson.subpackages || [];
+  appJson.pages = appJson.pages || [];
   return appJson;
 };
 
@@ -123,11 +124,11 @@ const fixAppJson = (appJson) => {
 async function buildOutputAppJson(tmsConfig, modules) {
   try {
     // 获取所有模块，合并模块依赖的模块
-    const modulesConfig = getModulesConfig(modules, tmsConfig.appName, false);
+    const modulesConfig = getModulesConfig(modules, tmsConfig, false);
     // 获取所有的分包
     const subPackages = getSubPackages(modulesConfig);
     // 获取app.json的配置
-    const appJson = getAppJsonContent(resolve('./app.json'));
+    let appJson = getAppJsonContent(resolve('./app.json'));
 
     // 更新app.json中的subpackages
     appJson.subpackages = subPackages;
@@ -138,7 +139,12 @@ async function buildOutputAppJson(tmsConfig, modules) {
     // 更新主包，需在subpackages处理完成后执行， pages/
     updateMainPackages(appJson, tmsConfig.mainPackages);
 
-    fs.writeFileSync(resolve(`${tmsConfig.outputDir}/app.json`), JSON.stringify(appJson, null, 2), 'utf8');
+    // 模板渲染：先将 app.json 转为字符串，然后通过 preprocess 渲染
+    const appJsonStr = JSON.stringify(appJson, null, 2);
+    const preprocessedStr = pp.preprocess(appJsonStr, tmsConfig.templateVars || {},  'json');
+    fs.writeFileSync(resolve(`${tmsConfig.outputDir}/app.json`), preprocessedStr, 'utf8');
+
+    appJson = JSON.parse(preprocessedStr);
 
     if (typeof tmsConfig?.hooks?.updateAppJson === 'function') {
       await tmsConfig?.hooks?.updateAppJson({

package/src/core/tmsMpconfig.js

@@ -5,6 +5,8 @@
 const loadash = require('lodash');
 const fs = require('fs');
 const path = require('path');
+const pp = require('preprocess');
+const JSON5 = require('json5');
 const { TMS_CONFIG_FILENAME, MODULE_CONFIG_FILENAME, TMS_PRIVATE_FILENAME } = require('../config/constant');
 const { resolve, isObject, isArray, getAbsolutePath } = require('../utils/widgets');
 const defaultTmsConfig = require('../config/defaultTmsConfig');
@@ -57,9 +59,15 @@ const getTmsConfig = (configPath) => {
     modules.all = tmsConfig.modules;
     tmsConfig.modules = modules;
   }
-  // 合并默认值
-  const res = loadash.mergeWith(tmsConfig, tmsPrivateCf, (objValue, srcValue) => {
-    if (loadash.isArray(objValue) && objValue[0] && loadash.isObject(objValue[0])) {
+  // 使用自定义的合并策略：
+  // 1. 对 templateVars 字段做浅合并（即把 tms.config.js 中的和 tms.private.config.js 中的对象合并，
+  //    如果存在同名字段则以 tms.private.config.js 中的为准）。
+  // 2. 对数组（并且数组元素为对象的情况）执行拼接
+  const res = loadash.mergeWith({}, tmsConfig, tmsPrivateCf, (objValue, srcValue, key) => {
+    if (key === 'templateVars') {
+      return { ...(objValue || {}), ...(srcValue || {}) };
+    }
+    if (Array.isArray(objValue) && objValue[0] && isObject(objValue[0])) {
       return objValue.concat(srcValue);
     }
   });
@@ -128,13 +136,18 @@ const adaptSubPackages = function (moduleConfig, appName) {
  * @param {array} modules 用户要编译的模块列表
  * @param { string } appName 小程序的名称
  */
-function getModulesConfig(modules = [], appName) {
+function getModulesConfig(modules = [], tmsConfig) {
+  const { appName } = tmsConfig;
   const modulesConfig = [];
   modules.forEach((moduleItem) => {
     const moduleConfigPath = resolve(moduleItem.path, MODULE_CONFIG_FILENAME);
     let moduleConfig;
     try {
-      moduleConfig = JSON.parse(fs.readFileSync(moduleConfigPath, 'utf-8'));
+      // 模板渲染：先将 module.config.json 转为字符串，然后通过 preprocess 渲染
+      const moduleConfigJsonStr = fs.readFileSync(moduleConfigPath, 'utf-8');
+      const preprocessedStr = pp.preprocess(moduleConfigJsonStr, tmsConfig.templateVars || {}, 'json');
+      // fs.writeFileSync(resolve(moduleConfigPath), moduleConfigJsonStr, 'utf8');
+      moduleConfig = JSON5.parse(preprocessedStr);
     } catch (e) {
       throw new Error(`${moduleConfigPath}json解析报错: ${e}`);
     }
@@ -241,11 +254,11 @@ const getModulesByMergeDepModules = (tmsConfig, modules, errorIsQuit = false) =>
           allModules.set(moduleItem.moduleName, moduleItem);
         }
         if (errorIsQuit) {
-          throw new Error(`${moduleItem.moduleName}模块的配置文件module.config.json在${moduleItem.path}目录下没有找到`);
+          throw new Error(`${moduleItem.moduleName}模块的配置文件module.config.json在${moduleItem.path}目录下没有找到 ${moduleConfigPath}`);
         }
         return;
       }
-      const [moduleConfig = {}] = getModulesConfig([moduleItem], tmsConfig.appName);
+      const [moduleConfig = {}] = getModulesConfig([moduleItem], tmsConfig);
 
       if (!allModules.has(moduleItem.moduleName)) {
         allModules.set(moduleItem.moduleName, checkModuleItem(tmsConfig, moduleItem, moduleConfig));

package/src/scripts/run/dev/index.js

@@ -2,6 +2,7 @@ const shelljs = require('shelljs');
 const compileDev = require('../../../compile/dev');
 const { resolve, filterField } = require('../../../utils/widgets');
 const init = require('../init/index');
+const { buildOutputAppJson } = require('../../../core/buildAppJson');
 const { getModulesByMergeDepModules, getSubPackages } = require('../../../core/tmsMpconfig');
 const { info } = require('../../../utils/log');
 const { global } = require('../../../utils/global');
@@ -40,6 +41,9 @@ async function dev(tmsConfig, targetModules) {
   // 初始化操作
   const { subPackages, modules: newModules } = await init(tmsConfig, targetModules);
 
+  // 在启动开发环境前主动执行生成 app.json
+  await buildOutputAppJson(tmsConfig, newModules);
+
   info('当前dev启动的有效模块', newModules.map(item => item.moduleName).sort());
   if (typeof tmsConfig?.hooks?.beforeFirstCompile === 'function') {
     await tmsConfig?.hooks?.beforeFirstCompile({