uniapp 每次运行 manifest.json 都会重置是怎么回事?

在使用uniapp开发时,每次运行项目后manifest.json文件都会被重置回初始状态,导致手动修改的配置全部丢失。请问这是什么原因导致的?如何解决这个问题?已经尝试过重新安装HBuilderX和清除缓存,但问题依然存在。

2 回复

manifest.json 在运行时会自动重置,可能是因为HBuilderX默认行为。建议检查项目配置,确保修改后保存并重新运行。也可尝试锁定文件权限或更新开发工具版本。


UniApp 每次运行时 manifest.json 文件被重置,通常是由于以下原因及解决方法:

1. 项目配置文件冲突

  • 原因manifest.json 是 UniApp 的核心配置文件,当项目中的 manifest.json 与 HBuilderX 或 CLI 工程配置不一致时,工具可能会自动覆盖重置。
  • 解决
    • HBuilderX 用户:通过可视化界面修改配置(点击 manifest.json 文件,在右侧图形界面调整),避免直接编辑源文件。
    • CLI 用户:确保通过 vue-cli-plugin-uni 的配置方式修改,例如在 vue.config.js 中定义 configureWebpack

2. 版本控制或文件权限问题

  • 原因:如果 manifest.json 被设为只读,或版本控制(如 Git)在切换分支时覆盖了该文件。
  • 解决
    • 检查文件权限,确保可写。
    • 若使用 Git,确认 manifest.json 未被忽略,并避免强制覆盖操作。

3. 开发工具缓存或插件干扰

  • 原因:HBuilderX 或自定义插件可能自动重置配置。
  • 解决
    • 重启 HBuilderX 或清除缓存(菜单栏:运行 → 清除缓存)。
    • 检查已安装插件,临时禁用可疑插件测试。

4. 项目结构异常

  • 原因:项目路径含特殊字符或嵌套过深,导致工具无法正确识别配置。
  • 解决:将项目移至纯英文路径,并确保结构符合 UniApp 规范。

操作建议:

  • 备份配置:修改前复制 manifest.json 内容,重置后对比差异。
  • 规范修改方式:始终通过开发工具的可视化界面或官方 CLI 命令调整配置。

若问题持续,请提供开发环境(如 HBuilderX 版本、项目类型)和重置时的具体报错信息,以便进一步排查。

回到顶部