devIndicators

devIndicators 允许您配置开发期间显示当前路由上下文信息的屏幕指示器。

Types

  devIndicators: false | {
    position?: 'bottom-right'
    | 'bottom-left'
    | 'top-right'
    | 'top-left', // 默认为 'bottom-left'
  },

将 devIndicators 设为 false 会隐藏指示器，但 Next.js 仍会显示遇到的任何构建或运行时错误。

故障排查

指示器未将路由标记为静态

如果您期望某个路由是静态的但指示器将其标记为动态的，很可能是该路由选择了退出静态渲染。

您可以通过运行 next build --debug 构建应用并在终端检查输出来确认路由是静态渲染还是动态渲染。静态（或预渲染）路由会显示 ○ 符号，而动态路由会显示 ƒ 符号。例如：

构建输出

Route (app)                              Size     First Load JS
┌ ○ /_not-found                          0 B               0 kB
└ ƒ /products/[id]                       0 B               0 kB

○  (Static)   预渲染为静态内容
ƒ  (Dynamic)  按需服务端渲染

当页面导出 getServerSideProps 或 getInitialProps 时，该页面会被标记为动态的。

版本历史

版本	变更
`v15.2.0`	改进了屏幕指示器并新增 `position` 选项。`appIsrStatus`、`buildActivity` 和 `buildActivityPosition` 选项已被弃用。
`v15.0.0`	新增静态屏幕指示器及 `appIsrStatus` 选项。

故障排查

指示器未将路由标记为静态

版本历史

On this page