Next.js 的 .gitignore
适用于 Next.js 的 17 条忽略规则，可直接复制到您的仓库。
React 生产框架
Next.js 的完整 .gitignore
# 由 LFGitignore - https://lfgitignore.com 生成
# 创建：2026-10-31 23:47:50 UTC
# 技术：Next.js
### Next.js ###
# macOS 文件夹设置（桌面服务存储）
.DS_Store
/node_modules
/.pnp
.pnp.js
/build
/coverage
/.next/
/out/
# 隐私增强邮件证书
*.pem
# npm 调试日志
npm-debug.log*
# Yarn调试日志
yarn-debug.log*
# Yarn错误日志
yarn-error.log*
.env*.local
# 环境变量
.env
# Vercel CLI 项目链接和设置
.vercel
# TypeScript 构建信息
*.tsbuildinfo
next-env.d.ts
这些 Next.js 规则实际上忽略了什么
以下列出了每个忽略模式及其加入 .gitignore 的原因。
通用
| 模式 | 忽略的内容 |
|---|---|
.DS_Store |
macOS 文件夹设置（桌面服务存储） |
/node_modules |
依赖关系 |
/.pnp |
通用 |
.pnp.js |
通用 |
/build |
通用 |
/coverage |
测试 |
/.next/ |
next.js |
/out/ |
通用 |
*.pem |
隐私增强邮件证书 |
npm-debug.log* |
npm 调试日志 |
yarn-debug.log* |
Yarn调试日志 |
yarn-error.log* |
Yarn错误日志 |
.env*.local |
本地环境文件 |
.env |
环境变量 |
.vercel |
Vercel CLI 项目链接和设置 |
*.tsbuildinfo |
TypeScript 构建信息 |
next-env.d.ts |
通用 |
如何将此 .gitignore 用于 Next.js
- 复制上面的Next.js规则，或者直接下载文件。
- 在 Git 仓库根目录创建名为 .gitignore 的文件，并将规则粘贴进去。
- 如果其中一些文件已被跟踪，请运行 git rm -r --cached . 然后再次提交 - Git 仅将忽略规则应用于未跟踪的文件。
- 提交 .gitignore 以便团队中的每个人都共享相同的规则。