安装
使用我们的在线启动器快速开始使用 Nuxt,或者从本地终端启动。
在线体验
如果你只是想在浏览器中把玩 Nuxt,而不想先搭建项目,可以使用这个在线沙盒:
新项目
前提条件
- Node.js -
22.x或更新版本(但我们推荐使用 当前 LTS 版本) - 文本编辑器 - 虽然没有 IDE 要求,但我们推荐使用 Visual Studio Code 搭配 官方 Vue 扩展(以前称为 Volar)或 WebStorm,它与 其他 JetBrains IDE 一起,开箱即用就能提供出色的 Nuxt 支持。如果你使用其他编辑器,例如 Neovim,可以按照 Vue Language Tools 安装指南 配置 Vue Language Server 支持。
- 终端 - 用于运行 Nuxt 命令
- Node.js:请确保使用偶数版本(22、24 等)
- Neovim:配置 Vue TypeScript 插件时,请确保
location指向@vue/language-server包目录,而不是其二进制文件。有关可用配置,请参阅 Neovim 安装指南。 - WSL:如果你在 Windows 上并遇到 HMR 较慢的问题,可以尝试使用 WSL(Windows Subsystem for Linux),它可能会解决一些性能问题。
- Windows 上 DNS 解析缓慢:在 Windows 上的本地开发服务器中,不要使用
localhost:3000,改用127.0.0.1,这样浏览器加载会快得多。
创建新项目
打开一个终端(如果你使用 Visual Studio Code,可以打开 集成终端),并使用以下命令创建一个新的启动项目:
npm create nuxt@latest <project-name> -- -t v3
yarn create nuxt <project-name> -t v3
pnpm create nuxt@latest <project-name> -t v3
# 当 https://github.com/oven-sh/bun/issues/29087 解决后,你可以使用这个命令
# bun create nuxt@latest <project-name> -t v3
bunx create-nuxt@latest init <project-name> -t v3
deno -A npm:create-nuxt@latest <project-name> -t v3
在 Visual Studio Code 中打开你的项目文件夹:
终端
code <project-name>
或者从终端切换到你的新项目目录:
cd <project-name>
开发服务器
现在你可以启动 Nuxt 应用的开发模式:
npm run dev -- -o
yarn dev --open
pnpm dev -o
bun run dev -o
# 使用 Bun 运行时进行开发
# bun --bun run dev -o
deno run dev -o
干得好!浏览器窗口应该会自动打开并访问 http://localhost:3000。
下一步
既然你已经创建了 Nuxt 项目,就可以开始构建你的应用了。