⚠️ Alpha内测版本警告:此为早期内部构建版本,尚不完整且可能存在错误,欢迎大家提Issue反馈问题或建议
Skip to content

1.1.4 亲眼看到第一个页面——Hello World 验证:本地开发服务器启动

一句话破题

这是全栈开发的"开机时刻"——启动开发服务器,在浏览器中看到你的第一个页面。

核心价值

Hello World 不仅仅是一个测试页面,它验证了整个开发环境的正确配置。如果你能看到这个页面,说明:

  • Node.js 运行正常
  • 项目依赖安装成功
  • Next.js 编译器工作正常
  • 本地服务器可以启动

启动开发服务器

确保你在项目目录下,运行:

bash
pnpm dev

你会看到类似这样的输出:

  ▲ Next.js 16.x.x
  - Local:        http://localhost:3000
  - Environments: .env.local

 ✓ Ready in 2.1s

访问你的页面

打开浏览器,访问 http://localhost:3000。你应该能看到 Next.js 的默认欢迎页面。

恭喜!你已经成功跑通了第一个 Next.js 项目。

修改页面内容

让我们做一个简单的修改来验证热更新:

  1. 用编辑器打开 src/app/page.tsx
  2. 找到页面中的文字,改成你想要的内容
  3. 保存文件

你会发现浏览器自动刷新,显示你修改后的内容。这就是 Next.js 的热模块替换功能,它让你的开发体验非常丝滑。

第一次修改示例

src/app/page.tsx 的内容替换为:

tsx
export default function Home() {
  return (
    <main className="flex min-h-screen flex-col items-center justify-center p-24">
      <h1 className="text-4xl font-bold">我的第一个 Next.js 应用</h1>
      <p className="mt-4 text-gray-600">Hello, Vibe Coding!</p>
    </main>
  );
}

保存后,浏览器会自动显示新内容。

开发服务器的常用操作

操作快捷键/命令
启动服务器pnpm dev
停止服务器Ctrl + C
重启服务器停止后再启动
清除缓存重启rm -rf .next && pnpm dev

常见问题排查

问题 1:端口被占用

Error: listen EADDRINUSE: address already in use :::3000

解决方案:换一个端口启动

bash
pnpm dev -p 3001

问题 2:依赖未安装

Cannot find module 'xxx'

解决方案:重新安装依赖

bash
pnpm install

问题 3:页面白屏

打开浏览器开发者工具(F12),查看 Console 面板的错误信息,复制给 AI 帮你排查。

里程碑达成

到这里,你已经完成了本节的全部目标:

  • [x] 选择并安装了代码编辑器
  • [x] 配置了 AI 助手
  • [x] 初始化了 Next.js 项目
  • [x] 启动了开发服务器
  • [x] 看到了第一个页面

下一步:学习 Vibe Coding 的核心心法,从"写代码"转变为"指挥 AI 写代码"。