Ubuntu上PHPStorm的版本控制集成怎么做

在Ubuntu系统上使用PHPStorm进行版本控制，其实核心就是三步：装好Git、配好环境、熟悉IDE里的操作。下面就把完整流程拆解一下，跟着走一遍就能上手。

一、安装Git并验证

Ubuntu终端里敲两行命令就行：

sudo apt update && sudo apt install git

装完了用 git --version 确认一下版本，看到输出就说明安装成功。

二、配置Git全局信息

提交代码时需要绑定身份信息，这里设置的用户名和邮箱要跟远程仓库（比如GitHub）的账户一致：

git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"

这些信息会记录在每一次提交的历史中，方便追溯是谁改了什么。

三、在PHPStorm中指定Git路径

• 打开PHPStorm，进入 File → Settings（或者快捷键 Ctrl+Alt+S）。
• 左侧找到 Version Control → Git。
• 在 Path to Git executable 里确认路径，Ubuntu 默认是 /usr/bin/git，一般不需要改。
• 点一下右侧的 Test 按钮，如果弹出“Git executable is valid”就说明连接成功。
• 最后点 OK 保存。

四、为新项目初始化Git仓库

打开一个还没加版本控制的项目：

• 在项目根目录右键，选择 Git → Initialize Repository。
• 这个操作会在项目文件夹里生成一个隐藏的 .git 目录，所有版本控制的核心数据都存放在这里。

五、关联已有项目到Git

如果项目里已经有很多代码但还没初始化，有两种方法：

• 方法一（IDE界面）：顶部菜单栏选 VCS → Enable Version Control Integration，对话框里选 Git，确认。
• 方法二（终端）：在项目目录下执行 git init，然后回到PHPStorm刷新一下项目即可。

六、添加文件到版本控制

把需要跟踪的文件纳入管理：

• 在项目视图中选中文件或文件夹（可多选），右键 → Git → Add。
• 添加后文件颜色会变成绿色，代表“已暂存”，准备提交。

七、提交更改

• 右键项目根目录或已暂存的文件，选 Git → Commit Directory。
• 在弹窗里写上提交信息（比如“修复登录页面bug”），勾选要提交的文件。
• 点击 Commit 按钮，本地仓库的提交就完成了。

八、配置远程仓库（可选）

要是想把代码推到GitHub或GitLab上：

• 先在远程平台创建一个空仓库，拿到仓库URL。
• PHPStorm里右键项目根目录，选 Git → Remotes，点 + 添加。
• 远程名称通常写 origin（默认别名），URL 粘贴进去，点OK保存。

九、推送与拉取代码

• 推送：右键项目根目录 → Git → Repository → Push，确认远程仓库和分支（比如 origin/main），点Push就把本地提交同步到远程了。
• 拉取：右键 → Git → Repository → Pull，选择远程仓库和分支，点Pull即可获取远程最新代码并合并到本地。

十、查看版本控制状态

点击PHPStorm底部工具栏的 Version Control 标签（快捷键 Alt+9），能直观看到文件状态：

• 绿色：已暂存，等待提交
• 蓝色：已修改但未暂存
• 红色：未跟踪，还没纳入版本控制
• 日志区域会显示提交历史，方便追溯每次改动

整个流程走下来，版本控制的基础操作就完全掌握了。后续需要分支管理、合并冲突等高级操作，也可以在这个基础上继续探索。