## 一、环境要求（必须满足）

* Node.js：20.x 或更高（推荐 20.x LTS）Nuxt

* 包管理器：npm / pnpm / yarn / bun（推荐 pnpm）

* 编辑器：VS Code 或 trae

检查版本：

``` bash

node  -v  # 输出 v20.x.x 或更高 课程 版本号 v21.7.3

npm  -v  # 建议 9.x+ 课程 版本号 10.5.0

```

## 二、安装 Node.js（如果未安装）

方式 1：官网下载（简单）

访问 https://nodejs.org/

* 下载 20.x LTS 版本

* 安装时默认勾选 “Node.js runtime”、“npm package manager”

* 安装完成后重启终端，再执行 node -v 验证

## 方式 2：用 nvm 管理多版本（推荐开发）

``` bash

# 安装 nvm（macOS/Linux）

curl  -o-  https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh  |  bash

# 安装 Node 21

nvm  install  21

nvm  use  21

nvm  alias  default  21  # 设为默认

```

Windows 用 nvm-windows

## 三、创建 Nuxt 4 项目（官方推荐）

### 1. 用 nuxi 初始化（推荐）

```bash

# 创建项目（自动用 Nuxt 4）

npx  nuxi@latest  init  my-nuxt4-app

# 进入项目目录

cd  my-nuxt4-app

```

初始化时会交互式选择：(教程选择yarn)

* 项目名称

* 包管理器（选 pnpm/npm/yarn）

### 2. 安装依赖

```bash

# 如果选了 pnpm（更快）

yarn  install

```

### 3. 启动开发服务器

```bash

yarn  run  dev

```

成功后访问：http://localhost:3000

![本地图](./images/nuxt_1.png)

## 四、总结

我们学习了一下内容

* 环境要求：Node.js 20.x+、pnpm/npm/yarn

* 安装方式：官网下载（简单）或 nvm 管理多版本（推荐）

* 创建项目：nuxi 初始化（官方）

* 启动项目：yarn run dev

* 访问项目：http://localhost:3000

* 项目结构：nuxt4-app/