在 Ubuntu 上集成版本控制到 PhpStorm
一 环境准备
- 安装 Git:在终端执行命令:sudo apt-get update && sudo apt-get install git。
- 配置全局身份:设置用户名与邮箱(将示例替换为你的信息):
git config --global user.name “Your Name”
git config --global user.email “youremail@example.com”
- 验证安装:执行 git --version,应输出版本号;如需确认身份配置,执行 git config --global --list。
二 在 PhpStorm 内配置 Git
- 打开设置:进入 File → Settings(macOS 为 Preferences),定位到 Version Control → Git。
- 指定 Git 可执行文件:在 Path to Git executable 填入 /usr/bin/git(通常无需更改)。
- 测试 Git:点击右侧 Test,看到版本号即表示集成成功。
三 初始化仓库与基本操作
- 初始化本地仓库:
- 方式一:在终端进入项目根目录,执行 git init。
- 方式二:在 PhpStorm 菜单 VCS → Initialize Repository,选择项目根目录。
- 添加与提交:
- 终端:git add . 与 git commit -m “Initial commit”。
- IDE:在 Version Control 工具窗口查看变更,右键项目选择 Git → Commit Directory 填写提交信息后提交。
- 推送与拉取:
- 关联远程:终端执行 git remote add origin <remote_repository_url>;或在 IDE 中 VCS → Git → Remotes → + 添加远程地址。
- 推送:终端 git push -u origin master(或 main);IDE 中点击 Push。
- 拉取:IDE 中点击 Pull 获取远程更新。
四 常见问题与排查
- Git 路径无效或未检测到:确认 /usr/bin/git 存在并可执行;必要时在设置中手动指定该路径并重新测试。
- 提交失败提示未配置用户名或邮箱:在项目根目录或全局执行 git config 设置 user.name 与 user.email 后重试。
- 无法连接远程仓库:检查远程 URL、网络与权限(如 SSH 密钥或 HTTPS 凭据);必要时在 IDE 的 Remotes 中更新地址。