为何npx create-next-app创建的全新项目npm run dev无响应且build失败？

核心原因 #

node:buffer 是Node.js内置模块的协议式导入语法，该特性从Node.js v14.13.0开始支持，但Next.js的最新稳定版本（搭配Tailwind CSS v3+）要求Node.js版本至少为v16.8.0或更高。如果本地Node.js版本低于这个要求，就会触发找不到模块的错误，同时导致开发服务无法正常启动。

解决步骤 #

• 检查当前Node.js版本：执行 node -v 查看版本号。
• 升级Node.js版本：
  • 若使用nvm（Node版本管理器），运行 nvm install --lts 安装最新长期支持版，再用 nvm use --lts 切换到该版本。
  • 直接从Node.js官网下载对应系统的安装包覆盖安装。
• 重新验证项目：
  1. 删除项目根目录下的 node_modules 文件夹和 package-lock.json 文件。
  2. 执行 npm install 重新安装依赖。
  3. 再次尝试 npm run dev 或 npm run build。

额外排查点 #

如果升级Node版本后问题仍存在，检查以下内容：

• 确认 next.config.js 中@/*别名配置正确，示例如下：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    reactStrictMode: true,
    swcMinify: true,
    paths: {
      '@/*': ['./src/*']
    }
  }
  
  module.exports = nextConfig
  

• 更新全局npm版本：执行 npm install -g npm@latest 确保npm为最新稳定版。

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