ubuntu中phpstorm如何使用git

Ubuntu 中 PhpStorm 使用 Git 的完整指南

在 Ubuntu 系统下用 PhpStorm 开发，Git 是绕不开的版本控制工具。今天就来聊聊如何把两者无缝衔接起来——从环境搭建到日常操作，再到那些让人头疼的报错排查，一次讲透。

一、环境准备

第一步当然是先把 Git 装好。操作很简单：打开终端，运行更新命令，然后安装，最后验证一下版本。

• 安装命令：sudo apt update && sudo apt install git
• 验证是否装好：git --version

装完之后，别忘了配置全局身份信息。这一步很关键，因为每次提交代码时，Git 都会用这个信息来记录是谁提交的。

• 配置用户名：git config --global user.name "Your Name"
• 配置邮箱：git config --global user.email "your_email@example.com"

这两条命令执行完，后续的提交记录就不会再报“找不到用户名或邮箱”的错误了。

二、在 PhpStorm 中配置 Git

环境准备好之后，进入 PhpStorm 的设置页面。路径是：

File → Settings → Version Control → Git

在“Path to Git executable”这一栏，通常填写 /usr/bin/git 即可。填好后点击“Test”按钮，如果显示版本号，说明配置成功。

如果需要对接 GitHub 或 GitLab 这样的托管平台，可以在设置中的“GitHub”页面登录账号，后续推送、拉取、克隆都会方便不少。

三、常用操作

下面这几项是日常开发中最高频的操作，逐一过一下。

初始化本地仓库

有两种方式可以开启版本控制：

• 通过菜单：VCS → Enable Version Control Integration，然后选择 Git
• 通过终端：在项目根目录执行 git init

两种方法效果一样，看个人习惯。

克隆远程仓库

如果要从远程仓库拉取代码，可以这样操作：

File → New → Project from Version Control → Git

在弹出的窗口中，填上远程仓库地址和本地存放路径，点击“Clone”即可。

提交更改

代码改完后，打开提交面板：

Git → Commit Directory（或者直接按 Ctrl+K）

在这里填写提交信息，勾选要提交的文件，然后点击“Commit”。

推送与拉取

推送：Git → Repository → Push

拉取：Git → Repository → Pull

这两个操作基本是成对出现的，开发中几乎每天都要用到。

分支管理

PhpStorm 右下角有一个 Git 分支按钮，点击后可以查看、切换、创建或合并分支，也支持检出远程分支。日常分支操作基本靠它就能搞定。

四、常见问题与排查

实际使用中，难免会遇到一些报错，下面几个是最常见的，解决办法也相对简单。

Git 路径无效或未检测到

如果 PhpStorm 提示找不到 Git，先去 Settings → Version Control → Git 确认路径是否为 /usr/bin/git，然后重新点击“Test”。很多时候只是路径填写不对。

提交时报错缺少用户名或邮箱

这种情况通常是因为全局配置没补全。用 git config --global user.name/email 补上即可，或者在 PhpStorm 的设置里直接填写 User name 和 Email。

无法连接 GitHub/GitLab

先去 Settings → GitHub 登录账号，或者检查一下网络环境。另外，远程仓库的 URL 是用的 SSH 还是 HTTPS，也需要确认，两种方式配置不同，选一种能用的就好。