NextJS中src/pages/_app.tsx未生效问题求助

以下是针对该问题的排查和解决步骤：

• 补全AppProps的导入语句
  你的代码中使用了AppProps类型但未导入，这会触发TypeScript编译错误，NextJS会自动回退到默认的_app实现，导致自定义文件被忽略。需补充导入：

  import type { AppProps } from 'next/app'
  
  export default function MyApp({ Component, pageProps }: AppProps) {
      debugger
      console.log('here')
      return <Component {...pageProps} />
  }
  

• 确认文件路径与命名规范
  确保文件严格命名为_app.tsx（全小写、下划线开头），且准确放在src/pages/目录下。NextJS对特殊页面的文件名大小写和路径有严格要求，拼写错误会导致框架无法识别。

• 清理正确的缓存目录
  你提到删除了.node文件夹，应该是指node_modules？除了这个，还需要删除NextJS的编译缓存目录.next，再重新安装依赖并启动服务：

  rm -rf node_modules .next
  npm install
  npm run dev
  

• 检查NextJS版本与src目录配置
  若使用的是v9及以前的旧版NextJS，需要在next.config.js中显式启用src目录支持：

  module.exports = {
    srcDir: true,
  }
  

  新版本NextJS默认支持src目录，此步骤可跳过。

• 验证TypeScript配置
  检查tsconfig.json的include字段是否包含src目录，确保TypeScript能正确处理该文件：

  {
    "include": ["src/**/*", "next-env.d.ts"]
  }
  

• 排查其他自定义页面干扰
  临时移除项目中的_document.tsx文件测试，确认是否因该文件存在错误导致_app无法正常加载（此情况较少见，但可作为兜底排查步骤）。

内容的提问来源于stack exchange，提问作者Faire