更新时间：2024-01-11 16:34:23贡献者收藏订阅更新我的文档设置返回文档项目配置（mini.project.json）新配置格式（format2）开放了诸多可以提升开发者研发效率的的配置，如 es5 新编译配置、typescript/less 转译、路径别名、全局对象访问策略等。开发者可以根据 项目配置 开启需要的功能，如当前项目仍处于旧配置格式，可以参照下述文档指南进行迁移。新增配置能力 新配置 说明 compileoptions.typescript小程序是否启用 typescript 支持，更多详情可查看 配置文档compileoptions.less小程序是否启用 less 支持，更多详情可查看 配置文档compileoptions.treeshaking是否在生产构建时进行 tree-shaking 优化，可查看 compileoptions.resolvealias小程序开发者工具 ide 3.7.5 开始支持路径别名配置, 更多详情可查看 配置文档compileoptions.globalobjectmode小程序全局对象（global/globalthis）访问策略, 更多详情可查看 配置文档compileoptions.transpile小程序代码转 es5 配置（新）, 更多详情可查看 配置文档developoptions.sourcemap是否开启生成 sourcemap自动升级ide 3.8.1 版本开始会帮助开发者自动升级 mini.project.json 内容，开发者只需要使用新版 ide 打开项目，即可自动升级。手动迁移迁移到新配置格式（format2）时，有部分配置项已被标记为废弃，强烈建议将这些废弃的配置项迁移至新的、能力更全面的配置项。node_modules 转译行为配置以下配置项涉及 node_modules 内转译行为●enablenodemodulebabeltransform●node_modules_es6_whitelist迁移案例 1：旧有配置无上述特殊转译行为选项此配置迁移前后均保持了对 node_modules 路径不开启任何 es 语法转译。旧有配置迁移后配置迁移案例 2：旧有配置使用 node_modules_es6_whitelist此配置迁移前后仅对 node_modules 中指定路径、npm 包忽略语法转译。旧有配置迁移后配置迁移案例 3：旧有配置使用 enablenodemodulebabeltransform此配置迁移前后对 node_modules 全量开启 es 语法转译。旧有配置迁移后配置注意 当存在较多 node_module 模块时，转译全部 node_modules 内的代码文件可能会大幅降低构建速度。如果您原来的配置开启了全部的 node_module 代码转译，即使您原来的配置为 案例 3， 仍建议您按照 案例 1 的方法进行迁移，再根据编译器的提示来开启指定 node_module 的代码转译。基础库 2.0由于小程序基础库 1.0 已不再进行功能迭代和问题修复，format2 将默认使用小程序基础库 2.0，如果您还在使用 1.0 基础库，请尽快参照 基础库 2.x 升级 将小程序升级至基础库 2.0。等效配置项 旧有配置 新配置 说明 includeassetsinclude明确语义，用户构建后需要打包至产物中的资产excludeuploadexclude明确语义，用户本地代码上传时需要忽略的文件debugoptionspluginresolution明确语义，用于插件快捷联调配置component2compileoptions.component2迁移字段enablehmrdevelopoptions.hotreload迁移字段enableparallelloaderdevelopoptions.parallel迁移字段enabledistfileminifydevelopoptions.minify迁移字段miniprogramrootminiprogramroot-pluginrootpluginroot-compiletypecompiletype-scriptsscripts-
