环境安装

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

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

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

• 编辑器：VS Code 或 trae

检查版本：

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

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

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

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

访问 nodejs.org/

• 下载 20.x LTS 版本

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

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

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

# 安装 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 初始化（推荐）

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

npx  nuxi@latest  init  my-nuxt4-app

# 进入项目目录

cd  my-nuxt4-app

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

• 项目名称

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

2. 安装依赖

# 如果选了 pnpm（更快）

yarn  install

3. 启动开发服务器

yarn  run  dev

成功后访问：localhost:3000

四、总结

我们学习了一下内容

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

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

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

• 启动项目：yarn run dev

• 访问项目：localhost:3000

• 项目结构：nuxt4-app/