使用官方安装器后Next.js Fast Refresh无法正常工作
针对你遇到的修改app/page.js后浏览器无更新、Fast Refresh不工作的问题,可按以下步骤排查解决:
检查开发服务器状态
确认npm run dev的终端无报错信息,比如ESLint语法错误、编译失败提示。若有报错,先修复对应问题再刷新页面。同时留意终端是否在文件保存后输出「event - compiled successfully」类的更新日志,若终端无反应,可能是编辑器未开启自动保存,或是文件权限存在问题。禁用浏览器缓存并强制刷新
打开浏览器开发者工具(F12),在「网络」选项卡勾选「禁用缓存」,再刷新页面;或使用快捷键强制刷新:Ctrl+Shift+R(Chrome/Edge/Firefox通用)。确认文件修改路径正确
对照你的文件夹结构截图,确保修改的是项目根目录下的app/page.js,而非其他不存在的目录(比如误操作了src文件夹,但你创建项目时未启用该目录)。重启开发服务器与浏览器
关闭当前运行npm run dev的终端,重新执行npm run dev启动服务器;同时完全关闭浏览器所有标签页后重新打开,访问http://localhost:3000。排查杀毒软件或Windows Defender干扰
部分杀毒软件或Windows Defender的实时保护可能会拦截Next.js的文件监听,导致无法检测到文件变化。可临时关闭实时保护测试,或把项目目录添加至信任列表。清理依赖与缓存重新构建
执行以下PowerShell命令清理缓存与依赖,重新安装后启动服务器:rm -Recurse node_modules rm -Recurse .next npm install npm run dev检查Next.js配置(若有自定义)
若项目中存在next.config.js,确认其中未设置fastRefresh: false(默认无此配置,若没有该文件可跳过此步骤)。
内容的提问来源于stack exchange,提问作者Aitor Martin

