框架

在阅读完通用贡献指南后，以下是对该仓库贡献的一些具体说明。nuxt/nuxt仓库。

Monorepo 指南

• packages/kit: 用于编写 Nuxt 模块的工具包，发布为@nuxt/kit.
• packages/nuxt: Nuxt 的核心，发布为nuxt.
• packages/schema: 跨版本 Nuxt 类型定义和默认值，发布为@nuxt/schema.
• packages/rspack: 适用于 Nuxt 的Rspack打包器，发布为@nuxt/rspack-builder.
• packages/vite: 适用于 Nuxt 的Vite打包器，发布为@nuxt/vite-builder.
• packages/webpack: 适用于 Nuxt 的webpack打包器，发布为@nuxt/webpack-builder.

设置

要为 Nuxt 做出贡献，您需要设置本地环境。

1. 将仓库Forknuxt/nuxt到您自己的 GitHub 帐户，然后将其克隆到您的本地设备。
2. 确保使用最新的Node.js
3. 启用Corepack以拥有 pnpm 和 yarn。
   终端

   corepack enable
   

4. 运行 pnpm install --frozen-lockfile 以使用 pnpm 安装依赖项。
   终端

   pnpm install --frozen-lockfile
   

   如果您要添加依赖项，请使用 pnpm add。
   pnpm-lock.yaml 文件是所有 Nuxt 依赖项的真实来源。
5. 激活被动开发系统。
   终端

   pnpm dev:prepare
   

6. 检出一个分支，您可以在其中工作并提交您的更改。
   终端

   git checkout -b my-new-branch
   

然后，在提交拉取请求之前，针对playground和测试您的更改。

演示

在处理拉取请求时，您可能需要检查您的更改是否正常工作。

您可以修改 playground/ 中的示例应用程序，然后运行

pnpm dev

测试

每个新功能都应该有相应的单元测试（如果可能）。此仓库中的 test/ 目录目前仍在开发中，但请尽力按照现有示例创建一个新测试。

在创建 PR 或将其标记为可供审查之前，请运行

pnpm test

以确保所有测试都通过。

您可能已经注意到，我们使用 ESLint 来强制执行编码标准。

在提交更改之前，要验证代码样式是否正确，请运行

pnpm lint

文档

如果您要添加新功能或重构或以任何其他方式更改 Nuxt 的行为，您可能需要记录这些更改。请将文档的任何更改包含在同一个 PR 中。您不必在第一次提交时就编写文档（但请在您的拉取请求足够成熟后尽快这样做）。

最终清单

提交 PR 时，您需要填写一个简单的模板。请在清单中勾选所有适当的“答案”。

文档指南

如果您发现我们可以改进文档或错误消息的地方，请务必提出 PR - 即使只是为了修复一个错字！

快速编辑

如果您发现错字或想要修改句子，可以点击右侧“社区”部分中的编辑此页面链接。

直接在 GitHub 界面中进行更改并打开拉取请求。

较长编辑

文档内容位于nuxt/nuxt仓库的 docs/ 目录中，并以 Markdown 格式编写。

代码检查文档

文档使用MarkdownLint等等case police进行检查，以保持文档的一致性。

pnpm lint:docs

打开 PR

请确保您的 PR 标题符合约定式提交指南。

docs: update the section about the nuxt.config.ts file