跳到内容

devIndicators

devIndicators 允许您配置在开发过程中提供当前正在查看的路由上下文的屏幕指示器。

类型
  devIndicators: false | {
    position?: 'bottom-right'
    | 'bottom-left'
    | 'top-right'
    | 'top-left', // defaults to 'bottom-left',
  },

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

故障排除

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

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

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

构建输出
Route (app)
  /_not-found
 ƒ /products/[id]
 
  (Static)   prerendered as static content
ƒ  (Dynamic)  server-rendered on demand

当从页面导出 getServerSidePropsgetInitialProps 时,它将被标记为动态。

版本历史

版本更改
v16.0.0appIsrStatusbuildActivitybuildActivityPosition 选项已移除。
v15.2.0改进了屏幕指示器,新增了 position 选项。appIsrStatusbuildActivitybuildActivityPosition 选项已弃用。
v15.0.0添加了带有 appIsrStatus 选项的静态屏幕指示器。