在 Ubuntu 上配置 PhpStorm 的版本控制
一 前置准备
- 安装并初始化 Git：在终端执行以下命令，完成安装与基础配置。
sudo apt update
sudo apt install git
git config --global user.name “Your Name”
git config --global user.email “you@example.com”
- 打开 PhpStorm，进入 File → Settings → Version Control → Git，在 Path to Git executable 填写 /usr/bin/git（通常无需改动）。以上确保系统与 IDE 的 Git 均可用。
二 将项目纳入 Git 版本控制
- 方式 A（命令行）
在项目根目录执行：
git init
git add .
git commit -m “Initial commit”
- 方式 B（IDE 操作）
打开项目后，依次选择 VCS → Enable Version Control Integration，在弹窗中选择 Git；随后通过 Git → Commit（或 Commit Directory）提交更改。以上两种方式等效，任选其一即可。
三 连接远程仓库与推送拉取
- 关联远程仓库（命令行）
git remote add origin https://github.com/username/repository.git
git branch -M main
git push -u origin main
- 关联远程仓库（IDE 操作）
在 Settings → Version Control → Git → Remotes 中点击 +，添加远程 URL（如：https://github.com/username/repository.git）；之后使用 Push/Pull 完成同步。
- 常用工作流
在 IDE 的 Version Control 工具窗口执行 Pull（拉取）、Commit（提交）、Push（推送）等操作，完成日常协作。
四 使用 SVN 或其他 VCS（可选）
- 安装与启用 Subversion 插件：File → Settings → Plugins，搜索 Subversion Integration 并安装，重启 IDE。
- 配置 SVN 路径：File → Settings → Version Control → Subversion，在 Path to Subversion executable 填写 /usr/bin/svn，点击 Test 验证。
- 基本操作：
- 检出：VCS → Checkout from Version Control → Subversion
- 提交：VCS → Commit Directory
- 更新：VCS → Get from Version Control → Subversion
以上步骤可在 PhpStorm 中完成 SVN 的集成与使用。
五 常见问题与排查
- Git 路径无效：确认 /usr/bin/git 存在且可执行（命令行执行 which git），必要时在 IDE 的 Git 设置中手动指定。
- 提交失败：检查是否已配置全局 user.name 与 user.email，或是否忘记执行 git add。
- 无法连接远程仓库：核对 HTTPS/SSH 地址、认证方式（账号/令牌/SSH 密钥）是否正确；必要时先在命令行完成一次 push 再回到 IDE。
- SVN 不可用：确认已安装 Subversion 客户端（命令行执行 svn --version），并在插件与路径设置中完成配置与测试。
