直接在PHP项目根目录运行git init即可初始化Git仓库，随后须创建.gitignore忽略vendor/、.env等文件，显式添加核心文件而非git add .，并配置正确的git user.name和user.email。
直接在 PHP 项目根目录运行 git init
PHP 本身不提供版本控制能力，所谓“初始化 PHP 项目版本库”，本质是为存放 PHP 文件的目录初始化 Git 仓库。只要项目文件已存在（比如有 index.php、composer.json 或 vendor/），进入该目录后执行：
git init即可创建
.git 子目录，完成版本库初始化。
常见错误是误以为要先写 PHP 代码再“注册”到 Git——Git 只认目录和文件，跟语言无关。哪怕目录里只有 README.md，也能 git init。
初始化后必须做三件事：忽略 vendor/、.env、缓存文件
PHP 项目常含大量不应提交的生成物或敏感配置，不加处理会导致仓库臃肿或泄露密钥。立即创建 .gitignore 并填入：
-
/vendor/— Composer 依赖，由composer install重建 -
.env— 环境变量文件，本地配置不应进仓库 -
/storage/framework/cache/、/storage/framework/sessions/— Laravel 类框架的运行时缓存 -
/var/、/logs/（若存在）— 日志和临时文件
没加 .gitignore 就先 git add .，很可能把整个 vendor/ 提交进去，后续清理麻烦且污染历史。
立即学习“PHP免费学习笔记（深入）”；
git add 时别用 git add . 直接全加
尤其当项目刚运行过 composer install 或框架命令（如 php artisan config:cache），目录里可能已混入不该跟踪的文件。更安全的做法是：
- 先
git status -u看哪些是未跟踪文件 - 用
git add index.php composer.json README.md显式添加核心文件 - 确认无误后再
git add src/ app/ config/等逻辑目录 - 避免
git add .一次吞掉所有未跟踪项
很多团队踩坑在于第一次提交就带进了 vendor/autoload.php 或 .env.example 的错误副本，后期改名或删文件都留有历史痕迹。
首次提交前检查 git config 用户信息是否正确
Git 提交需要绑定作者身份，如果全局没设或设错，会导致提交记录显示 unknown@localhost 或邮箱不统一，影响协作追溯。运行以下命令确认：
git config --global user.name "Your Name"<br>git config --global user.email "you@example.com"
若只想对当前项目单独设置（比如工作/个人邮箱混用），去掉 --global，并在项目目录内运行：
git config user.name "Team Name"<br>git config user.email "team@company.com"
注意：git config 输出为空或报错，说明配置缺失；提交后发现作者名异常，基本就是这里没配好——不是 PHP 问题，但直接影响版本库可信度。
