安装
通过我们的在线入门模板快速开始使用 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>
yarn create nuxt <project-name>
pnpm create nuxt@latest <project-name>
bun create nuxt@latest <project-name>
deno -A npm:create-nuxt@latest <project-name>
在 Visual Studio Code 中打开你的项目文件夹:
Terminal
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 项目,就可以开始构建你的应用了。