github/gitignore · Nextjs.gitignore
Next.js-.gitignore-Vorlage erklärt
Erklärt, warum Nextjs.gitignore .next, out, node_modules, .env-Dateien, .vercel, next-env.d.ts und *.pem ignoriert, und wie sie sich von der Node-Vorlage unterscheidet.
Nextjs.gitignore entspricht nahezu der .gitignore, die create-next-app erzeugt. Die meisten Regeln beginnen mit / und sind im Repository-Stamm verankert. Liegt die App in einem Monorepo in einem Unterordner, passen Sie die Pfade an oder verwenden Sie zusätzlich die Node-Vorlage.
Next.js liest mehrere Umgebungsdateien wie .env, .env.local oder .env.development.local. Diese Vorlage schließt sowohl .env als auch .env*.local aus.
Regeln im Einzelnen
| Muster | Was ignoriert wird und warum |
|---|---|
/.next//out//build | Next.js-BuildErgebnisse und Cache von next build (.next) sowie Ergebnisse des statischen Exports (out). Sie werden bei der Bereitstellung neu erzeugt. |
/node_modules/.pnp.pnp.js | AbhängigkeitenErgebnisse der Paketinstallation und Dateien von Yarn Plug'n'Play. Da sie nur am Stamm verankert sind, blockieren sie node_modules in Unterpaketen nicht. |
.env.env*.local | UmgebungsvariablenUmgebungsdateien mit geheimen Werten. Variablen, die mit NEXT_PUBLIC_ beginnen, werden in den Build aufgenommen und im Browser sichtbar; Geheimnisse verwenden Sie daher ohne dieses Präfix nur auf dem Server. |
.vercelnext-env.d.ts*.tsbuildinfo | Bereitstellungs- und generierte TypdateienVon vercel link erzeugte Projektverknüpfungsdaten, die Typdeklarationsdatei, die Next.js bei Entwicklung und Build neu erzeugt, sowie Informationen für inkrementelle TypeScript-Builds. |
*.pem | ZertifikateZertifikats- und private Schlüsseldateien (.pem) für lokale HTTPS-Entwicklung oder die Anbindung externer Dienste. Private Schlüssel werden nicht committet. |
npm-debug.log*yarn-debug.log*yarn-error.log*/coverage.DS_Store | Logs und SonstigesLogs des Paketmanagers, Testabdeckung und Finder-Dateien von macOS. |
Hinweise für die Praxis
- In einem Monorepo (
apps/web) gelten am Stamm verankerte Regeln wie/node_modulesnicht für die App im Unterordner. Wählen Sie zusätzlich die Node-Vorlage, werdennode_modules/in jeder Tiefe erfasst. - Konfigurationsdateien und Lockfile wie
next.config.jsundpackage-lock.jsonwerden committet. - Statt
.envzu committen, teilen Sie die Namen der benötigten Variablen in der README oder in.env.example.
Originalvorlage
Nextjs.gitignore
# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.# dependencies/node_modules/.pnp.pnp.js# testing/coverage# next.js/.next//out/# production/build# misc.DS_Store*.pem# debugnpm-debug.log*yarn-debug.log*yarn-error.log*# local env files.env*.local.env# vercel.vercel# typescript*.tsbuildinfonext-env.d.ts
Vorlagenquelle: github/gitignore/Nextjs.gitignore @356fd7b (2026-09-11) · CC0-1.0