PHPStorm在Linux上的版本控制集成

Linux下 PhpStorm 版本控制集成指南

一 环境准备

• 安装 Git
  • Ubuntu/Debian：sudo apt update && sudo apt install -y git
  • CentOS/RHEL：sudo yum install -y git（或使用 dnf）
• 配置全局身份
  • git config --global user.name “Your Name”
  • git config --global user.email “you@example.com”
• 验证安装
  • git --version 应输出版本号（如：2.39.x 或更高）
• 说明
  • PhpStorm 的 VCS 菜单在新建项目时也可直接选择 Enable Version Control Integration 启用 Git。

二 在 PhpStorm 内配置 Git

• 打开设置：File > Settings（Linux 为 Ctrl+Alt+S），进入 Version Control > Git
• 设置 Git 可执行文件路径：Path to Git executable 填写 /usr/bin/git，点击 Test 验证
• 确认用户信息：在设置中填写 User Name 与 User Email（与 git config 一致）
• 首次使用
  • 初始化本地仓库：VCS > Enable Version Control Integration > 选择 Git
  • 克隆远程仓库：VCS > Git > Clone，输入仓库 URL 与目标目录

三 常用操作与远程协作

• 提交与推送
  • 提交：右键项目或文件 > Git > Commit（或 Commit Directory），输入提交信息
  • 推送：VCS > Git > Push（或 Commit and Push）
• 拉取与更新
  • 拉取：VCS > Git > Pull
• 远程管理
  • 添加/修改远程：VCS > Git > Remotes，新增如 https://github.com/user/repo.git
• 共享代码
  • 在本地仓库首次推送时设置上游分支，或直接在 Remotes 中添加远程后 Push

四 其他版本控制与排错

• 使用 SVN（可选）
  • 安装插件：Settings > Plugins > 搜索并安装 Subversion Integration，重启 IDE
  • 配置路径：Settings > Version Control > Subversion，设置 svn 可执行文件路径并 Test
  • 检出：VCS > Checkout from Version Control > Subversion
• 常见问题排查
  • Git 路径错误：确保 Path to Git executable 为 /usr/bin/git 并可 Test 成功
  • 提交身份不一致：IDE 中的 User Name/Email 需与 git config 一致
  • 权限或网络问题：检查 SSH 密钥或 HTTPS 凭据；必要时在终端先完成一次 git pull/push 验证网络与认证