【微信小程序】微信小程序中的.json文件不能添加注释原因及解决办法

最新推荐文章于 2025-03-27 16:00:00 发布

橙子有糖

最新推荐文章于 2025-03-27 16:00:00 发布

阅读量4.2k

点赞数 5

分类专栏：微信小程序文章标签：前端

本文链接：https://blog.youkuaiyun.com/qq_42347235/article/details/108929455

版权

8 篇文章

订阅专栏

本文介绍了在微信小程序开发过程中遇到的.json文件无法添加注释的问题及其原因，由于.json文件仅支持特定的数据结构，注释会导致编译错误。解决方案是利用合法的数据结构添加间接注释，例如通过创建包含注释信息的对象或数组。然而，这种做法可能会引发警告，提示存在无效数据。

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

微信小程序中的.json文件不能添加注释原因及解决办法

今天学习微信小程序开发的时候给.json文件中添加了注释，之后报错。情况如下：
注释内容
在这里插入图片描述
报错内容应该是：数据类型未定义。

后来百度得知：.json文件中只允许出现两种数据结构
一种是：属性名：键值即 key：value；
另一种是：值的有序列表即 Array[]（pages字段就属于这一种）
所以，以//开头或/**/形式的注释就都不能正确编译了。

可以采用曲线救国的形式添加注释，在符合json文件的数据结构要求的情况下添加。
具体做法示例：

  "coment":{"用于指定小程序由哪些页面组成,并且文件名不需要带后缀，实际上是代指这个文件夹下的这个文件名的所有文件，不管后缀是什么，所以没有文件后缀，微信框架会自动去相应文件夹去找到那几个文件（.wxml，.wxss，.js，.json）进行处理":""},

或

  "newcoment":["用于指定小程序由哪些页面组成,并且文件名不需要带后缀，实际上是代指这个文件夹下的这个文件名的所有文件，不管后缀是什么，所以没有文件后缀，微信框架会自动去相应文件夹去找到那几个文件（.wxml，.wxss，.js，.json）进行处理"],

但是
我想，这样的写法应该不太符合规范。
——————————分隔符——————————
2020年10月9日更新
如果采用上面的方式写注释，会有警告
在这里插入图片描述
告诉你你写了两个没用的数据。