# 在 Next.js 项目中安装 PRNext：快速入门

从现有的 Next.js 项目开始，并在 22.x 行中使用 Node.js 22.23.4+，在 24.x 行中使用 24.22.1+，或者从 26.12.1 开始支持的版本。从项目文件夹运行命令。

把你的工作放在一个分支上。 PRNext 是具有部分 Next.js 兼容性的 alpha 版本，因此请随时检查您的应用程序。

## 安装 PRNext

从项目文件夹运行此命令。保留更新的锁定文件，以便后续安装使用相同的依赖项集。

```sh
npm install @thomas.f/prnext
```

## 迁移您的脚本

将您的开发、构建和启动脚本移至 PRNext，然后运行兼容性检查。如果您想首先检查其更改，请将 --dry-run 添加到迁移命令中。在继续之前，请阅读任何报告的不兼容性。

```sh
npx --no-install prnext migrate .
npx --no-install prnext check .
```

## 开发您的应用程序

启动开发服务器并打开终端中打印的地址。编辑组件，保存并在浏览器中检查结果。测试您在项目中使用的至少一项路线更改和一项交互。

```sh
npx --no-install prnext dev .
```

## 构建并运行

构建应用程序，然后在本地启动生成的输出。在部署之前检查相同的页面、表单和 API 路由。有效的开发会话不足以验证生产版本，尤其是在实验运行时。

```sh
npx --no-install prnext build .
npx --no-install prnext start .
```

[PRNext 和 Next.js：兼容性和迁移指南](/zh/blog/prnext-nextjs-compatibility-migration)

[PRNext 适合您的 Next.js 应用吗？](/zh/blog/is-prnext-right-for-your-app)

[在 VPS 上部署 Next.js：从构建到 HTTPS](/zh/blog/deploy-nextjs-vps)

已发表: 2026-10-24

修改的: 2026-10-27

作者: PRNext

---

语言: zh-Hans

Canonical: https://prnext.dev/zh/blog/getting-started-with-prnext

Index: https://prnext.dev/llms.txt