github/gitignore · Laravel.gitignore

Laravel .gitignore 模板详解

说明 Laravel.gitignore 忽略 vendor、node_modules、.env、public/storage 符号链接、Vite 构建、Passport 密钥和 auth.json 的原因。

在生成器中打开 与 Composer, Node, JetBrains, macOS 一起打开

Laravel.gitignore 面向使用 Composer 和 npm 安装依赖的 Laravel 应用。它在与 Laravel 项目默认自带的 .gitignore 类似的规则基础上,增加了 Homestead、Vagrant 等开发环境文件。

最重要的是 .env。Laravel 从 .env 读取数据库密码、APP_KEY、邮件与支付 API 密钥,因此一旦提交该文件,应用的全部机密都会暴露。

逐条规则详解

模式忽略什么,为什么忽略
/vendor/node_modules/依赖通过 composer installnpm install 重新生成的目录。提交 composer.lockpackage-lock.json,确保安装相同的版本。
.env.env.backup.env.production环境文件应用机密和各环境的设置。变量列表通过 .env.example 共享,此模板不会忽略该文件。
public/storagepublic_html/storagestorage/*.key存储链接与密钥php artisan storage:link 生成的符号链接,以及 Passport 的 OAuth 私钥(oauth-private.key)。链接在每台服务器上重新创建,密钥属于机密。
/public/buildpublic/hotpublic_html/hotnpm-debug.logyarn-error.log前端构建Vite 生成的构建结果,以及表示开发服务器正在运行的 hot 文件。如果提交了 hot 文件,生产服务器会尝试从不存在的开发服务器加载资源。
.phpunit.result.cache/.phpunit.cache测试缓存PHPUnit 用来记录失败测试顺序等信息的缓存。
Homestead.yamlHomestead.json/.vagrant.phpactor.json/storage/pail开发环境与工具个人的 Homestead 设置、Vagrant 状态、Phpactor 设置以及 Laravel Pail 日志文件。
auth.jsonComposer 认证保存私有包仓库令牌和密码的 Composer 认证文件。
bootstrap/compiled.phpapp/storage/旧版路径Laravel 4 时代的编译文件和存储路径。新版本中不会再生成。

实践中的注意事项

原始模板

Laravel.gitignore规则 23 行
/vendor/node_modules/npm-debug.logyarn-error.log# Laravel 4 specificbootstrap/compiled.phpapp/storage/# Laravel 5 & Lumen specificpublic/storagepublic/hot# Laravel 5 & Lumen specific with changed public pathpublic_html/storagepublic_html/hotstorage/*.key.envHomestead.yamlHomestead.json/.vagrant.phpunit.result.cache/.phpunit.cache/public/build/storage/pail.env.backup.env.production.phpactor.jsonauth.json

模板来源: github/gitignore/Laravel.gitignore @356fd7b (2026-09-11) · CC0-1.0

常搭配使用的模板

其他模板详解