watch-admin 模式默认启用

页面摘要： 在 Strapi 5 中，strapi develop 默认以 watch-admin 模式启动，因此管理面板无需任何额外标志即可热重载。使用 --no-watch-admin 可禁用它。

watch-admin 模式会在你编辑管理面板源文件时自动重载管理面板。在 Strapi v4 中，你必须显式请求此行为，而在 Strapi 5 中它是默认开启的，你需要的是选择退出。

本页面是破坏性变更数据库的一部分，提供有关该破坏性变更的信息，以及从 Strapi v4 迁移到 Strapi 5 的附加说明。

破坏性变更说明

在 Strapi v4 中

watch-admin 模式默认禁用。你使用 --watch-admin 标志启动它：

strapi develop --watch-admin

另外还有一个独立的 strapi watch-admin 命令可用。

在 Strapi 5 中

watch-admin 模式默认启用，因此单独的 strapi develop 就会热重载管理面板。--no-watch-admin 标志可禁用它：

strapi develop --no-watch-admin

独立的 strapi watch-admin 命令已被移除。

迁移

本节汇总了关于该破坏性变更的有用说明和操作步骤。

说明

在 Strapi 5 中传递 --watch-admin 并不是错误，因为该标志仍然存在且已默认为 true。使用该标志的脚本仍能正常工作，但该标志是多余的。

如果禁用了 watch-admin 模式，你也可以使用 --no-build-admin 来阻止构建管理面板。

手动迁移

要迁移到 Strapi 5：

1. 在你的 package.json 脚本、Dockerfile 和 CI 配置文件中搜索 --watch-admin 和 strapi watch-admin。
2. 将任何 strapi watch-admin 命令替换为 strapi develop。
3. 移除现在多余的 --watch-admin 标志，或者如果你希望显式声明也可以保留它们。
4. 在不能热重载管理面板的命令中添加 --no-watch-admin，例如那些之前依赖 watch-admin 模式默认关闭的脚本。