1. 安装Git
在Ubuntu终端中执行以下命令安装Git(若未安装):
sudo apt update && sudo apt install git
安装完成后,通过git --version验证是否安装成功。
2. 配置Git全局信息
设置提交时使用的用户名和邮箱(需与远程仓库账户一致):
git config --global user.name "Your Name"
git config --global user.email "youremail@example.com"
这些信息将关联到所有Git提交记录。
3. 在PHPStorm中配置Git可执行文件路径
- 启动PHPStorm,点击顶部菜单栏File > Settings(或快捷键
Ctrl+Alt+S)。
- 展开左侧Version Control选项,点击Git。
- 在Path to Git executable输入框中,确认或选择Git的安装路径(Ubuntu默认路径为
/usr/bin/git)。
- 点击右侧Test按钮,验证PHPStorm能否正确连接Git(显示“Git executable is valid”即为成功)。
- 点击OK保存设置。
4. 初始化Git仓库(新项目)
- 打开需要版本控制的项目。
- 右键点击项目根目录,选择Git > Initialize Repository。
- 此操作会在项目根目录生成
.git隐藏文件夹(版本控制的核心配置目录)。
5. 关联现有项目与Git(已有代码)
- 若项目已存在且未初始化Git,可通过以下两种方式关联:
- 方式一:通过PHPStorm界面操作:点击顶部菜单栏VCS > Enable Version Control Integration,在弹出的对话框中选择Git,点击OK。
- 方式二:通过终端进入项目目录,执行
git init命令,再回到PHPStorm刷新项目。
6. 添加文件到版本控制
- 在项目视图中,右键点击需要跟踪的文件或文件夹(或选中多个文件),选择Git > Add。
- 添加后,文件状态会变为“绿色”(已暂存),表示已纳入版本控制准备提交。
7. 提交更改
- 右键点击项目根目录或已暂存的文件,选择Git > Commit Directory。
- 在弹出的提交窗口中,输入提交信息(描述本次更改内容,如“修复登录页面bug”),勾选需要提交的文件。
- 点击Commit按钮,完成本地仓库提交。
8. 配置远程仓库(可选,推送至GitHub/GitLab等)
- 若需将代码同步到远程仓库(如GitHub),需先在远程平台创建空仓库。
- 右键点击项目根目录,选择Git > Remotes,点击**+**号添加远程仓库。
- 输入远程名称(通常为
origin,默认别名)和仓库URL(如https://github.com/username/repo.git),点击OK保存。
9. 推送/拉取代码
- 推送代码到远程仓库:右键点击项目根目录,选择Git > Repository > Push,确认远程仓库和分支(如
origin/main),点击Push即可将本地提交同步到远程。
- 拉取远程更新:右键点击项目根目录,选择Git > Repository > Pull,选择远程仓库和分支,点击Pull即可获取远程最新代码并合并到本地。
10. 查看版本控制状态
- 点击PHPStorm底部工具栏的Version Control标签(或快捷键
Alt+9),可查看文件的状态:
- 绿色:已暂存(等待提交);
- 蓝色:已修改(未暂存);
- 红色:未跟踪(未纳入版本控制);
- 日志区域会显示提交历史,方便追溯更改。