uniapp踩坑记录：项目配置出错，libVersion字段需为string
2023-07-30 16:26:24
UniApp 常见踩坑：libVersion 字段务必为字符串
UniApp 是一款颇受开发人员青睐的跨平台开发框架，凭借一套代码即可同时开发多个平台的应用。然而，在使用 UniApp 开发小程序时，一个常见的错误可能会让开发者头疼不已：
错误提示：libVersion 字段需为字符串
当你在编译小程序时遇到如下的报错：
project.config.json 文件内容错误: project.config.json: libVersion 字段需为 string.
这表明你在 project.config.json 文件中配置的 libVersion 字段存在问题。
libVersion 字段详解
libVersion 字段用于指定小程序库的版本，它必须是一个字符串。小程序库是 UniApp 提供的一组工具和 API，用于构建小程序应用。如果 libVersion 字段的值不是字符串，就会导致编译失败。
解决方法
解决这个问题的方法很简单，只需将 project.config.json 文件中的 libVersion 字段的值改为字符串即可：
- 打开
project.config.json文件。 - 找到
libVersion字段。 - 将
libVersion字段的值改为一个字符串，例如"2.10.3"。 - 保存
project.config.json文件。
代码示例：
{
"appid": "wx123456789",
"projectname": "My App",
"setting": {
"urlCheck": true,
"es6": true,
"postcss": true,
"minified": true,
"newFeature": true,
"useCompiler": "webpack5",
"useScopedStyle": true,
"useShadowDom": true,
"generate": "ui",
"customTheme": ""
},
"libVersion": "2.10.3"
}
注意事项
libVersion字段的值必须是字符串，不能是数字或其他类型的数据。libVersion字段的值必须是小程序库的版本号。- 如果你使用的是 UniApp 官方提供的默认模板，那么
libVersion字段的值应该是"2.10.3"。
常见问题解答
1. 为什么 libVersion 字段必须是字符串？
libVersion 字段用于指定小程序库的版本，小程序库是一组工具和 API，用于构建小程序应用。小程序库的版本是一个字符串，因此 libVersion 字段也必须是一个字符串。
2. 如何获取小程序库的版本号？
你可以通过以下方式获取小程序库的版本号：
- 在 UniApp 官网上查看最新版本。
- 在
package.json文件中查看dependencies对象中的@dcloudio/uni-app包的版本号。
3. 更新小程序库版本后需要做什么？
更新小程序库版本后，你需要：
- 重新编译小程序应用。
- 重新发布小程序应用。
4. 如何避免踩到这个坑？
在编写 project.config.json 文件时，务必确保 libVersion 字段的值是一个字符串。你可以使用代码编辑器或 IDE 来检查字段类型。
5. 如果我已经踩到了这个坑，如何修复？
如果你已经踩到了这个坑，只需按照本文中的步骤将 project.config.json 文件中的 libVersion 字段的值改为一个字符串即可。
