PHP版本控制团队协作指南
PHP项目依赖Git协作，推荐简化GitFlow：main仅通过PR合并、develop用于集成测试、feature分支基于develop创建；.env和vendor/需忽略，composer.lock必须提交；统一PSR-12规范并用php-cs-fixer自动格式化。
PHP项目依赖Git协作，推荐简化Git Flow：main仅通过PR合并、develop用于集成测试、feature分支基于develop创建；.env和vendor/需忽略，composer.lock必须提交；统一PSR-12规范并用php-cs-fixer自动格式化。
PHP 项目本身不提供版本控制，团队协作必须依赖 Git 这类外部工具——不是“PHP 怎么做版本控制”，而是“PHP 团队怎么用 Git 高效协作”。
Git 分支策略怎么选：main / develop / feature？
PHP 团队常用的是 Git Flow 简化版，而非严格遵循原始模型。关键不是名字，而是职责是否清晰：
main（或master）只允许通过 PR 合并，永远对应线上可部署状态develop是集成分支，每日构建/测试目标，不应长期偏离mainfeature/xxx必须基于最新develop创建，完成功能后合入develop，不直连main- 避免使用
git push --force推送develop或main，尤其当多人共用时会丢提交
PHP 项目哪些文件不该进 Git？.env 和 vendor/ 怎么处理
PHP 项目中误提交敏感配置或第三方包是高频事故点：
.env必须加入.gitignore，部署时由运维单独注入；若需示例，提交.env.example并在 README 中说明字段含义vendor/不进 Git（除非极特殊离线环境），靠composer install恢复；CI/CD 流程中应运行composer install --no-dev生产环境安装composer.lock必须提交——它锁定依赖版本，否则composer install在不同机器上可能装出不一致的包- 生成的缓存目录如
var/cache/（Symfony）、storage/framework/（Laravel）也应忽略
如何避免 PHP 协作中的编码冲突？psr-12 和 php-cs-fixer 实操建议
格式不统一不是风格问题，是合并冲突放大器。手动解决 前空格、括号换行差异极其低效：
- 团队统一使用
php-cs-fixer+.php-cs-fixer.php配置，推荐基于psr-12扩展，禁用自动加declare(strict_types=1)（避免历史文件批量报错） - CI 流水线中增加
php-cs-fixer --dry-run --diff检查，失败则阻断合并 - 编辑器（VS Code）安装 PHP CS Fixer 插件，设置 “Format on Save”，但不要依赖它替代 CI 校验
- 禁止提交含
var_dump()、dd()、die()的调试代码——可用phpstan或自定义正则 pre-commit hook 拦截
本地开发和 CI 环境的 PHP 版本不一致怎么办？
本地跑通但 CI 报 ParseError: syntax error, unexpected token "string"（PHP 8.0+ 的命名参数语法）很常见：
- 在
composer.json的config.platform.php显式声明目标 PHP 版本，例如"platform": {"php": "8.1.0"}，让composer install模拟该环境解析依赖 - 用
php -v和composer show php双重确认当前实际版本与声明是否一致 - Docker 开发环境优先使用官方
php:8.1-apache镜像，而非宿主机 PHP；CI 脚本开头加php -v && composer --version日志输出，便于排查 - 避免在
if (PHP_VERSION_ID >= 80100)中混写新旧语法，PHP 8.0 下会直接 Parse Error，而不是运行时报错
真正的协作卡点往往不在 Git 命令本身，而在对 composer.lock 的信任程度、对 .env 生命周期的理解、以及是否把格式检查当成“可选项”。这些细节一旦松动，每天都会多出 15 分钟在 merge conflict 和 CI 失败上。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
