Ubuntu中PHPStorm的版本控制如何设置

Ubuntu中PHPStorm版本控制设置指南

一 前置准备

• 安装 Git：在终端执行命令：sudo apt update && sudo apt install git。
• 配置全局 Git 身份：执行命令：git config --global user.name “Your Name” 与 git config --global user.email “you@example.com”。
• 打开 PHPStorm，进入设置：File → Settings（macOS 为 PhpStorm → Preferences）。

二 在PHPStorm内配置Git

• 指定 Git 可执行文件路径：Settings → Version Control → Git → Path to Git executable，一般填写 /usr/bin/git。
• 验证 Git 是否可用：点击右侧 Test 按钮，出现版本号即表示配置成功。
• 设置提交者信息：在 Settings → Version Control → Git 中填写 User name 与 Email（与全局配置保持一致更便于统一）。

三 将项目纳入版本控制

• 方式 A（已有本地仓库）：在终端进入项目根目录，执行 git init，然后在 PHPStorm 打开该项目，IDE 会自动识别为 Git 仓库。
• 方式 B（IDE 初始化）：在 PHPStorm 菜单 VCS → Enable Version Control Integration，选择 Git 完成绑定。
• 添加与提交：在项目中右键文件/目录选择 Git → Add，再右键选择 Git → Commit Directory 输入提交信息完成提交。
• 关联远程仓库：
  • 命令行执行：git remote add origin <远程仓库URL>；
  • 或在 PHPStorm：VCS → Git → Remotes → +，填写名称（如 origin）与 URL。

四 日常协作操作

• 推送与拉取：在 PHPStorm 使用 VCS → Git → Push 与 VCS → Git → Pull，或在底部 Version Control 工具窗口点击 Push/Pull。
• 查看状态与历史：在 Version Control 窗口可查看文件状态（未跟踪、已修改、已暂存等），并支持查看提交历史、对比差异。
• 分支与合并：通过 Git Branches 弹出窗口进行创建、切换、合并与解决冲突等操作。

五 常见问题排查

• Git 路径无效：确认 /usr/bin/git 存在且可执行，必要时在终端运行 which git 获取实际路径并在 IDE 中填写。
• 提交作者信息不符：在 IDE 的 Git 设置或命令行中统一 user.name 与 user.email。
• 无法连接远程仓库：检查远程 URL、网络与权限（HTTPS 需凭证、SSH 需配置密钥），必要时在 Remotes 中重新添加。
• 菜单项缺失：确认项目已通过 Enable Version Control Integration 启用版本控制或已执行 git init。