在 Ubuntu 上使用 PhpStorm 进行版本迭代
一 环境准备与 Git 集成
- 安装 Git：在终端执行 sudo apt update && sudo apt install git，完成后用 git --version 验证。
- 在 PhpStorm 中配置 Git：打开 File → Settings → Version Control → Git，将 Path to Git executable 设为 /usr/bin/git（一般会自动检测）。
- 初始化或关联远程仓库：
- 新项目：VCS → Initialize Repository，选择项目根目录执行初始化。
- 已有仓库：VCS → Git → Remotes 添加远程地址（如 git@github.com:user/repo.git 或 https 地址）。
- 首次提交与推送：在 Commit 工具窗口勾选要提交的文件，填写提交信息，点击 Commit；随后 VCS → Git → Push 推送到远程（如 main 或 master）。
二 日常迭代流程
- 拉取最新变更：VCS → Git → Pull，选择目标分支（如 origin/main），保持本地与远程同步，减少冲突。
- 开发规范执行：按任务创建短期分支（如 feature/user-login、bugfix/header-crash），完成后合并回主干。
- 提交与推送：在 Commit 窗口执行 Add → 填写清晰的提交信息 → Commit；需要时执行 Push 将提交同步到远程。
- 查看历史与差异：Log 标签查看提交历史、分支图与变更对比，便于代码审查与回滚定位。
三 分支管理与代码审查
- 分支操作：在底部 Git 工具窗口或 VCS → Git → Branches 中创建、切换、合并与删除分支；功能开发建议基于 main 创建 feature/，修复问题使用 bugfix/。
- 合并与冲突解决：在 Merge 或 Rebase 过程中如出现冲突，PhpStorm 会标记冲突文件；打开冲突文件，使用内置的三路合并工具选择保留内容，保存后标记为已解决并执行 Commit。
- 代码审查配合：推送至远程后，可在 GitHub/GitLab 创建 Pull Request/Merge Request，团队成员在线评审、讨论与批准后再合并到主干。
四 版本发布与回滚
- 打标签发布版本：在 Log 或 Branches 界面选择目标提交，右键 Create Tag（如 v1.2.0），用于标记发布节点；推送标签到远程：VCS → Git → Push → 勾选 Push Tags。
- 回滚与重置：
- 回退工作区到某次提交：Git → Reset Current Branch to Here，选择 Soft/ Mixed/ Hard 策略（Soft 保留更改便于重新提交，Mixed 保留工作区更改，Hard 丢弃更改）。
- 回滚已推送的提交：优先使用 Revert Commit 生成反向提交，避免改写公共历史；确需改写历史时，在确认影响范围后使用 Reset 并强制推送（git push --force-with-lease），并通知团队成员。
五 常见问题与最佳实践
- 无法识别 Git：确认系统已安装 Git 且路径为 /usr/bin/git；必要时在 Settings → Version Control → Git 中手动指定。
- 提交前运行检查：启用 Before Commit 的 Reformat Code、Optimize Imports、Run Tests 等检查项，降低引入问题。
- 保持提交原子化：每次提交只做一件事，信息遵循约定（如：feat: 新增登录校验、fix: 修复空指针）。
- 频繁同步主干：定期 Pull 上游变更，减少合并冲突与重复劳动。
- 备份与导出设置：重要发布前可 File → Manage IDE Settings → Export Settings 备份 IDE 配置，便于迁移与恢复。