devIndicators

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

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

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

故障排除

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

如果您预期某个路由应为静态但被指示器标记为动态,很可能该路由已选择退出静态渲染。

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

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

  (Static)   prerendered as static content
ƒ  (Dynamic)  server-rendered on demand

当页面导出 getServerSidePropsgetInitialProps 时,该页面会被标记为动态。

版本历史

版本变更
v15.2.0改进屏幕指示器并新增 position 选项。弃用 appIsrStatusbuildActivitybuildActivityPosition 选项。
v15.0.0新增静态屏幕指示器功能,支持 appIsrStatus 选项。

On this page