首次在Mac上安装Next.js遇ERESOLVE依赖冲突错误如何解决？

你遇到的是npm依赖解析冲突问题，核心原因是项目声明的eslint@^8版本和eslint-config-next@14.2.3的peer依赖要求出现匹配异常，下面是几种可行的解决方法：

方法1：创建项目时添加--legacy-peer-deps参数 #

直接在创建命令后加上该参数，绕过npm的严格peer依赖检查：

npx create-next-app@14.2.3 my-next-app --legacy-peer-deps

（把my-next-app换成你想要的项目名称）

方法2：手动初始化并安装依赖（更稳妥） #

如果不想使用legacy参数，可以手动搭建项目结构：

1. 创建项目目录并初始化npm：

mkdir my-next-app && cd my-next-app
npm init -y

2. 手动安装Next.js核心依赖和指定版本的eslint：

npm install next@14.2.3 react react-dom
npm install --save-dev eslint@8.57.0 eslint-config-next@14.2.3

3. 在package.json中添加Next.js常用脚本：

"scripts": {
  "dev": "next dev",
  "build": "next build",
  "start": "next start",
  "lint": "next lint"
}

方法3：换用pnpm或yarn包管理器 #

如果频繁遇到npm的依赖问题，可以尝试用其他包管理器：

• 安装pnpm：

curl -fsSL https://pnpm.io/install.sh | sh -

• 用pnpm创建Next.js项目：

pnpm create next-app@14.2.3 my-next-app

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