HarmonyOS 鸿蒙Next 预览时报错@previewer/no-unallowed-decorator-on-root-component，如何解决？查阅官网需在code-linter.json5配置规则，但项目中未找到该文件

发布于 1周前 作者 songsunli 来自 鸿蒙OS

HarmonyOS 鸿蒙Next 预览时报错@previewer/no-unallowed-decorator-on-root-component，如何解决？查阅官网需在code-linter.json5配置规则，但项目中未找到该文件

请问预览时报这个错@previewer/no-unallowed-decorator-on-root-component，查阅官网在code-linter.json5配置规则，目前没在项目中找到这个文件


更多关于HarmonyOS 鸿蒙Next 预览时报错@previewer/no-unallowed-decorator-on-root-component，如何解决？查阅官网需在code-linter.json5配置规则，但项目中未找到该文件的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html

Harmonyos Next教程
2 回复
code-linter.json5配置规则，可以参考这个文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/ide-code-linter-0000001363071681-V5#section1782903483817，不过还是要以手机的运行结果为主

这个规则配置是代码检查阶段，在代码开发阶段，确保代码质量，而编译器的预览就属于是运行阶段了，的代码中存在[@Link](/user/Link)装饰器，所以预览还是预览不出来，建议还是运行在模拟器或者手机上面查看效果

更多关于HarmonyOS 鸿蒙Next 预览时报错@previewer/no-unallowed-decorator-on-root-component，如何解决？查阅官网需在code-linter.json5配置规则，但项目中未找到该文件的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


针对@previewer/no-unallowed-decorator-on-root-component报错，此错误通常表明在HarmonyOS鸿蒙Next预览环境中，根组件上使用了不被允许的decorator（装饰器）。在鸿蒙系统中，组件的装饰器使用需严格遵循框架规范。

  1. 检查根组件装饰器：首先，确认根组件上是否错误地使用了预览环境不支持的装饰器。鸿蒙系统中，某些装饰器可能仅适用于特定类型的组件或特定场景。

  2. 创建或修改code-linter.json5：由于报错提示需要在code-linter.json5中配置规则，若项目中未找到该文件，需手动创建。该文件用于定义代码检查规则，可防止类似错误发生。示例内容如下：

{
  "rules": {
    "@previewer/no-unallowed-decorator-on-root-component": "off"
  }
}

此配置将禁用对根组件上不允许装饰器的检查，但建议仅在明确知道为何需要这样做时才使用，以避免潜在问题。

  1. 重新运行预览：在修改或添加配置文件后，重新运行预览，检查是否还存在报错。

如果问题依旧没法解决请联系官网客服,官网地址是：https://www.itying.com/category-93-b0.html

回到顶部