【Uni-App】微信小程序编译每次都出现[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string

RisunJan

已于 2024-02-01 17:24:59 修改

阅读量1.7k

点赞数 21

分类专栏： Uni-app 文章标签： uni-app 微信小程序 json

于 2024-02-01 08:03:05 首次发布

本文链接：https://blog.csdn.net/qq_32808455/article/details/135955333

版权

文章讲述了在微信小程序开发中遇到的由于使用非稳定版开发工具导致的问题，提供了解决方案，即在`manifest.json`中配置`libVersion`为latest，并提醒读者关闭自动更新功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在这里插入图片描述

产生原因

当前用的开发工具版本不是稳定版

解决办法

根据微信小程序文档内容进行配置。

值	说明
latest	最新的非灰度中的基础库
trial	最新的基础库
widelyUsed	使用比例最高的基础库

在 manifest.json中加入

"mp-weixin" : {
     
  "libVersion": "latest",

最低0.47元/天解锁文章

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

RisunJan

关注关注

21
点赞
踩
11

收藏

觉得还不错? 一键收藏
2
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
打赏
打赏
打赏举报

举报

专栏目录

uniapp - 微信小程序报错[ project.config.json 文件内容错误]project.config.json: libVersion 字段需为 string，string(env:

高级前端工程师

03-16

5059

uniapp，微信小程序，运行编译报错，uniApp小程序编译报错，uni-app微信小程序加载运行时出现报错，Uni-App微信小程序编译每次都出现[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string，[project.config.json 文件内容错误]，出现报错怎么解决，uniapp报错解决方法，详细教程，uniapp小程序官方文档，升级uniapp后小程序编译提示，[ project.config.jso

【微信小程序】5步轻松创建uni-app项目，微信小程序开发从此得心应手

java专栏

11-16

997

通过本文的详细介绍，相信你已经成功在你的电脑上创建了一个uni-app项目，并且能够编写和调试一个简单的微信小程序。从准备工作、安装uni-app CLI、创建项目、编写第一个uni-app项目，到预览和调试、上传和发布，每一个步骤都详细解析，希望能帮助你轻松上手uni-app的开发。如果你有任何疑问或需要进一步的帮助，欢迎随时留言交流。祝你在uni-app的开发之旅中一帆风顺！希望这篇文章对你有所帮助，如果你有任何问题或需要进一步的解释，欢迎随时提问！😊。

2 条评论您还未登录，请先登录后发表或查看评论

升级uniapp后小程序编译提示[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为string

疯癫居士

03-01

749

升级uniapp后小程序编译提示[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为string。

[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string, string

weixin_43877368的博客

04-15

4564

解决方式：根据引用中的描述，需要注意修改project.config.json文件中的libVersion字段，确保其值为字符串类型。如果配置文件中的libVersion字段不是字符串类型，就会出现错误。manifest.json => 源码视图 => mp-weixin。3.确保libVersion字段的值是一个字符串，例如：“随便"。1.打开project.config.json文件。2. 找到libVersion字段。3. 保存文件并重新构建小程序。

uniapp或微信小程序项目的project.config.json配置文件

Tomorrow belongs to those who prepare for it today.

03-21

531

可以配置项目在微信开发者工具中的行为，配置文件中的。project.config.json是。

[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string

Frank_colo的博客

01-30

3042

关闭微信开发者工具，注销账号，删掉vscode之前编译的dist包，重新编译，重新登录微信开发者工具，导入新的dist,就可以了。

uniapp编译小程序报错[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string

一个超爱喝可乐的web前端攻城狮

01-23

3600

uniapp编译小程序报错[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string。

uniapp运行微信小程序，解决出现[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string的问题

m0_72762367的博客

03-01

2031

找到manifest.json，源码视图 ”mp-weixin“对象加上"libVersion": "latest"，重新运行就解决了。

基于uniapp设计的微信小程序源码.zip

05-27

7. **project.config.json**：微信开发者工具的项目配置文件。 8. **manifest.json**：uniapp的配置文件，定义了项目的环境变量、依赖等。 9. **package.json**：项目的依赖管理和脚本定义，包括uniapp插件和npm包。...

微信小程序编译每次都出现[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string

weixin_45395283的博客

12-20

4239

"libVersion": "latest"

【微信小程序开发】解决出现[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string的问题

Chanyto的博客

02-27

3520

【微信小程序开发】解决出现[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string的问题

project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string, string

weixin_40390063的博客

07-24

277

家人们，遇到了一个新的报错于是从网上找了各种方法，有说把开发者工具关闭重启的，有说开发者工具下载重新下载的，有说开发者工具路径安装得在C盘的，均没有效果解决方法：1、运行项目，在开发者工具中在文件根目录找到project.config.json文件2、“libVersion”: “latest”上面是小程序原生的办法，...

uniapp微信小程序编译时抛错，project.config.json 文件内容错误]project.config.json:libVersion 字段需为 string，string(env:W

T3165919332的博客

10-08

445

今天在uniapp的，pages.json中修改了标题名字后,并且修改了微信版本，代码并没有错误，但是微信开发工具编译时抛出以下错误。在uniapp中的manifest.json中添加"libVersion":"latest"字段通常指的是小程序的基础库版本，它用于指定开发者希望使用的微信提供的基础库版本。具体来说，是该文件中的。这个报错信息表明，在小程序的项目配置文件。

[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为

大华的程序人生

01-30

1170

uniapp编译的微信小程序，开发者工具打开报错 project.config.json: libVersion 字段需为

微信开发者工具解决 [ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string, string 问题

weixin_43462310的博客

04-21

706

由于我使用 HBuilder 编写代码，所有要在 HBulider 中修改代码，找到项目根目录下【manifest.json】文件，找到【源码视图】下【mp-weixin】，添加代码。

微信小程序点击page-container的预览代码，弹出错误 project.config.json: libVersion 字段需为 string, string(env: Windows,mp

qq_64135449的博客

02-25

1798

解决方法是在资源管理器（代码文件栏）中找到project.config.json的文件，再找到 libVersion字段。然后把后面dev位置改成“基础库版本的版本号”

【报Bug】微信小程序编译每次都出现[ project.config.json 文件内容错误] project.config.json: libVersion 字段需为 string, string

Liheishuai的博客

02-21

846

微信小程序编译报错[ project.config.json 文件内容错误]

{ "name": "uni-preset-vue", "version": "0.0.0", "scripts": { "dev:app": "uni -p app", "dev:app-android": "uni -p app-android", "dev:app-ios": "uni -p app-ios", "dev:custom": "uni -p", "dev:h5": "uni", "dev:h5:ssr": "uni --ssr", "dev:mp-alipay": "uni -p mp-alipay", "dev:mp-baidu": "uni -p mp-baidu", "dev:mp-jd": "uni -p mp-jd", "dev:mp-kuaishou": "uni -p mp-kuaishou", "dev:mp-lark": "uni -p mp-lark", "dev:mp-qq": "uni -p mp-qq", "dev:mp-toutiao": "uni -p mp-toutiao", "dev:mp-weixin": "uni -p mp-weixin", "dev:quickapp-webview": "uni -p quickapp-webview", "dev:quickapp-webview-huawei": "uni -p quickapp-webview-huawei", "dev:quickapp-webview-union": "uni -p quickapp-webview-union", "build:app": "uni build -p app", "build:app-android": "uni build -p app-android", "build:app-ios": "uni build -p app-ios", "build:custom": "uni build -p", "build:h5": "uni build", "build:h5:ssr": "uni build --ssr",

最新发布

04-17

<think>好的，我现在需要解决用户在使用uni-preset-vue构建项目时缺少app.json的问题。首先，我得回忆一下uni-app的结构和uni-preset-vue的作用。uni-app项目通常通过vue-cli创建，使用uni-preset-vue作为预设配置，这样能生成跨平台的项目结构。用户提到构建后缺少app.json，这可能导致微信小程序无法正常运行，因为app.json是小程序的全局配置文件。根据用户提供的引用信息，特别是引用[2]和[3]，uni-preset-vue是一个预设配置，帮助开发者用Vue CLI创建uni-app项目，支持多平台发布。用户可能按照文档使用vue-cli创建项目，但构建后没有生成app.json。这时候，我需要考虑几个可能的原因： 1. **项目结构问题**：uni-app的标准结构里，app.json可能被其他文件替代，比如manifest.json或pages.json，而构建时才会生成app.json。用户可能没有正确配置这些文件，导致构建时没有生成。 2. **编译配置错误**：uni-preset-vue可能需要特定的编译设置来生成目标平台的文件。用户可能在构建时没有指定正确的平台，或者配置有误，导致app.json未被生成。 3. **路径或构建脚本问题**：构建后的文件可能输出到不同的目录，用户可能没有检查正确的目录，或者构建脚本没有正确复制或生成app.json。接下来，我需要参考用户之前的问题和回答。用户之前的问题是关于IDEA中构建后缺少app.json，当时的解决方案分场景处理，包括跨平台框架、原生项目和混合项目。现在用户具体提到使用uni-preset-vue，属于跨平台框架的情况，因此之前的场景1可能适用，但需要更针对uni-preset-vue的细节。根据引用[3]，使用vue-cli创建项目时，可以选择不同的模板，比如vite或vite-ts。用户可能下载了模板，但模板中是否包含必要的配置？或者是否需要手动配置？可能的解决步骤包括： - **检查manifest.json配置**：uni-app的manifest.json负责应用的全局配置，包括各平台的特定设置。用户需要确保在manifest.json中正确配置了微信小程序的appid和相关设置，这样构建时才会生成对应的app.json。 - **确认编译命令**：构建微信小程序需要使用特定的npm脚本，比如`npm run build:mp-weixin`，这样uni-app编译器才会生成针对微信小程序的目录结构，包括app.json。 - **检查输出目录**：构建后的文件可能输出到dist目录下的子目录，如`dist/build/mp-weixin`，用户需要确认是否在该路径下查找app.json，而不是项目根目录。 - **手动创建app.json**：如果自动生成失败，可能需要手动创建app.json，并确保内容符合微信小程序的要求，如包含pages数组和window配置等。但根据uni-app的机制，通常不需要手动创建，因为pages.json会被编译成app.json。此外，用户可能需要检查uni-app的版本和依赖是否正确安装，确保编译过程没有出错。如果编译过程中有错误提示，需要根据提示信息进行调试。还需要考虑用户是否在vue.config.js中进行了自定义配置，可能会影响输出结果。例如，是否修改了输出路径或复制文件的规则，导致app.json未被正确复制到目标目录。最后，参考之前的回答，可能需要指导用户检查编译后的目录结构，确保微信开发者工具正确指向生成目录，并在必要时调整project.config.json中的miniprogramRoot设置。</think>#### 解决方案：使用`uni-preset-vue`构建项目时修复缺失`app.json`的完整流程 --- ### 一、问题根源定位 `uni-preset-vue`是基于Vue CLI的uni-app预设模板，其**核心配置逻辑**是通过`pages.json`和`manifest.json`生成各平台配置文件（如微信小程序的`app.json`）[^2]。缺失`app.json`通常由以下原因导致： 1. **编译命令未指定目标平台**：未触发微信小程序专用构建流程。 2. **`manifest.json`配置不完整**：缺少微信小程序平台的必要字段。 3. **输出目录未正确映射**：构建结果未同步到开发者工具指定路径。 --- ### 二、分步骤解决方案 #### 步骤1：验证项目初始化完整性 1. **检查模板下载** - 使用引用[3]提供的模板地址下载`vite`或`vite-ts`版本，确保初始项目包含以下关键文件： ```bash ├── src │ ├── pages # 页面目录（必须至少包含一个页面） │ ├── manifest.json # 跨平台配置 │ └── pages.json # 路由及样式配置 ``` 2. **安装依赖** - 在项目根目录执行： ```bash npm install ``` 确保`@dcloudio/uni-cli-shared`等核心依赖已正确安装。 #### 步骤2：配置`manifest.json`微信小程序参数 1. **添加微信平台配置** - 在`src/manifest.json`中添加或完善以下字段： ```json { "mp-weixin": { "appid": "你的微信小程序AppID", // 必须填写有效ID（测试时可留空） "setting": { "urlCheck": false, // 关闭域名校验 "es6": true, // 启用ES6转ES5 "postcss": true // 启用PostCSS处理 }, "usingComponents": true // 启用自定义组件 } } ``` - 若无微信配置块，构建时不会生成`app.json`[^2]。 #### 步骤3：执行定向编译命令 1. **触发微信小程序构建** - 在终端运行以下命令，明确指定目标平台： ```bash npm run build:mp-weixin ``` - 成功编译后，检查`dist/build/mp-weixin`目录，生成的`app.json`将在此路径下[^2]。 #### 步骤4：配置开发者工具路径映射 1. **修改`project.config.json`** - 在项目根目录创建或修改`project.config.json`，指定微信开发者工具的小程序根目录： ```json { "miniprogramRoot": "dist/build/mp-weixin", "setting": { "autoAudits": false // 关闭自动审核 } } ``` - 在微信开发者工具中导入项目时，选择此配置文件[^2]。 --- ### 三、关键配置示例 #### `pages.json`与`app.json`的映射关系 - **`pages.json`示例（开发者维护）** ```json { "pages": [ { "path": "pages/index/index", "style": { "navigationBarTitleText": "首页" } } ], "globalStyle": { "navigationBarTextStyle": "black" } } ``` - **编译生成的`app.json`（自动生成）** ```json { "pages": ["pages/index/index"], "window": { "navigationBarTitleText": "首页", "navigationBarTextStyle": "black" } } ``` 该文件由`uni-cli`根据`pages.json`和`manifest.json`合并生成。 --- ### 四、高级调试技巧 1. **强制清理构建缓存** - 删除`dist`目录和`node_modules/.vite`缓存文件夹后重新构建： ```bash rm -rf dist && rm -rf node_modules/.vite && npm run build:mp-weixin ``` 2. **检查编译日志** - 观察构建过程中是否出现以下关键日志： ```bash [vite] 开始生成微信小程序配置文件... [uni] 已生成 app.json -> /dist/build/mp-weixin/app.json ``` 若未显示，说明编译流程未正确触发。 --- ### 五、常见问题排查表 | 现象 | 解决方案 | |--------------------------|--------------------------------------------------------------------------| | 编译后`dist`目录为空 | 检查`package.json`中是否包含`build:mp-weixin`脚本 | | 开发者工具提示“无效的project.config.json” | 确认`miniprogramRoot`路径使用绝对路径或正确相对路径[^2] | | 页面样式丢失 | 在`manifest.json`中启用`"postcss": true`并检查`uni.scss`全局变量引入 | --- #### 相关问题 1. 如何为`uni-preset-vue`项目配置多环境下的微信小程序AppID？ 2. 使用`uni-preset-vue`时如何处理微信小程序的自定义组件兼容性问题？ 3. 如何优化`uni-app`编译微信小程序时的构建速度？