PhpStorm 2021.3 Help

设置 Git 存储库

当您克隆现有 Git 存储库或将现有项目置于 Git 版本控制下时,PhpStorm 会自动检测您的计算机上是否安装了 Git。如果 IDE 找不到 Git 可执行文件,它会建议下载它。

PhpStorm 支持来自 Windows 子系统 Linux 2 (WSL2) 的 Git,它在Windows 10 版本 2004中可用。

如果 Windows 上未安装 Git,PhpStorm 会在 WSL 中搜索 Git 并从那里使用它。此外,对于使用\\wsl$路径打开的项目,PhpStorm 会自动从 WSL 切换到 Git。

如果您需要手动配置 PhpStorm 以使用 WSL 中的 Git,请转到版本控制 | 在 IDE 设置的GitCtrl+Alt+S页面,点击Path to Git executable字段中的Browse图标,然后通过路径选择 Git from WSL ,例如.\wsl$\\wsl$\debian\usr\bin\git

从远程主机签出项目(克隆)

PhpStorm 允许您检出(用 Git 术语clone)现有存储库并根据您下载的数据创建一个新项目。

  1. 从主菜单中,选择Git | 克隆,或者,如果当前没有打开任何项目,请在欢迎屏幕上单击从 VCS 获取。

  2. 在“从版本控制获取”对话框中,指定要克隆的远程存储库的 URL,或选择左侧的 VCS 托管服务之一。

    如果您已经登录到选定的托管服务,完成将建议您可以克隆的可用存储库列表。

  3. 点击克隆。如果要基于已克隆的源创建项目,请在确认对话框中单击是。Git 根映射会自动设置到项目根目录。

    如果您的项目包含子模块,它们也将被克隆并自动注册为项目根目录。

将现有项目置于 Git 版本控制之下

您可以基于现有项目源创建本地 Git 存储库。

将整个项目与单个 Git 存储库相关联

  1. 打开要放在 Git 下的项目。

  2. VCS 操作弹出窗口或VCS主菜单中选择启用版本控制集成 Alt+`

  3. 选择Git作为版本控制系统,然后单击OK

  4. 启用 VCS 集成后,PhpStorm 会询问您是否要通过 VCS 共享项目设置文件。您可以选择始终添加以与使用 PhpStorm 的其他存储库用户同步项目设置。

    提示选择如何处理配置文件的通知

将项目中的不同目录与不同的 Git 存储库相关联

  1. 打开要放在 Git 下的项目。

  2. 从主菜单中,选择VCS | 创建 Git 存储库

  3. 在打开的对话框中,指定将在其中创建新 Git 存储库的目录。

    Git 不支持外部路径,因此如果您选择项目根目录之外的目录,请确保要创建存储库的文件夹也包含项目根目录。

  4. 如果您在项目结构中创建多个 Git 存储库,请为每个目录重复前面的步骤。

为项目初始化 Git 存储库后,您需要将项目文件添加到存储库。

将文件添加到本地存储库

  1. Commit工具窗口Alt+0中,展开Unversioned Files节点。

  2. 选择要添加到 Git 的文件或整个更改列表,然后从上下文菜单中按Ctrl+Alt+A或选择添加到 VCS 。

    您还可以从项目工具窗口将文件添加到本地 Git 存储库:选择要添加的文件,然后按Ctrl+Alt+A或选择Git | 从上下文菜单中添加。

在您的项目中启用 Git 集成后,PhpStorm 建议在 Git 下添加每个新创建的文件,即使它是从 PhpStorm 外部添加的。您可以在版本控制 |中更改此行为。IDE设置的确认Ctrl+Alt+S页面。如果您希望某些文件始终保持未版本化,您可以忽略它们

从版本控制中排除文件(忽略)

有时您可能需要保留某些文件未版本化。这些可以是 VCS 管理文件、实用程序的工件、备份副本等。您可以通过 PhpStorm 忽略文件,IDE 不会建议将它们添加到 Git 并将它们突出显示为已忽略。

您只能忽略未版本化文件,即您在未版本化文件更改列表中看到的文件。如果文件已添加到 Git但未提交,您可以在Local Changes视图中右键单击它 并选择Rollback

Git 允许您在两种配置文件中列出被忽略的文件模式:

  • .git/info/排除文件。

    此文件中列出的模式仅适用于存储库的本地副本。

    当您初始化或签出 Git 存储库时,会自动创建此文件。

  • VCS 根目录及其子目录中的一个或多个.gitignore文件。

    这些文件被签入存储库,以便整个团队都可以使用其中的忽略模式。因此,它是存储被忽略文件模式的最常见位置。

    如果 VCS 根目录下没有.gitignore文件,可以右键单击 Project 窗口中的任意位置,选择New | 文件并在“新建文件”对话框中键入.gitignore 。

将文件添加到 .gitignore 或 .git/info/exclude

  1. 决定要使用哪种Git 配置文件来忽略文件。如果有疑问,请使用.gitignore

  2. 在“本地更改”视图或“项目”工具窗口中找到要忽略的未版本化文件或文件夹 。这些视图中的文件颜色可帮助您识别文件的状态。

  3. 右键单击选择并选择Git | 添加到 .gitignoreGit | 添加到 .git/info/exclude

    这些视图中的文件颜色可帮助您识别文件的状态。

如果您需要按某种模式排除文件,或者某种类型的文件,您可以直接编辑.gitignore.git/info/exclude文件。请参阅.gitignore 模式格式

检查项目状态

PhpStorm 允许您与项目的存储库版本相比,检查本地工作副本的状态。它使用特定的颜色让您查看哪些文件已被修改,哪些新文件已添加到 VCS,以及 Git 未跟踪哪些文件。

打开本地更改视图。

  • Changes 更改列表显示自上次与远程存储库同步以来已修改的所有文件(以蓝色突出显示),以及已添加到 VCS 但尚未提交的所有新文件(以绿色突出显示)。

  • Unversioned Files 更改列表显示了所有已添加到项目中但 Git 未跟踪的文件。

有关更改列表的更多信息,请参阅将更改分组到不同的更改列表中。

在编辑器中跟踪对文件的更改

您还可以在编辑器中修改文件时跟踪对文件的更改。所有更改都使用更改标记突出显示,更改标记出现在已修改行旁边的装订线中,并显示自上次与存储库同步以来引入的更改类型。当您将更改提交到存储库时,更改标记会消失。

您对文本进行的更改是用颜色编码的:

  • 新添加行的标记行添加。

  • 修改线的标记线变了。

  • 已删除行的标记行已删除。

您可以使用将鼠标光标悬停在更改标记上然后单击它时出现的工具栏来管理更改。工具栏与显示修改行的先前内容的框架一起显示:

修改后的线标记

您可以通过单击回滚更改,还原图标并通过单击探索当前行的当前版本和存储库版本之间的差异显示差异图标

您可以复制此弹出窗口的任何部分内容并将其粘贴到编辑器中,而不是还原整个文件。

添加远程存储库

如果您基于本地源创建了 Git 存储库,则需要添加一个远程存储库以便能够在您的 Git 项目上进行协作,并消除将所有代码库存储在本地的风险。当您需要共享您的工作并从中提取数据以将其他贡献者所做的更改集成到您的本地存储库版本中时,您可以将更改推送到远程存储库。

如果您已经克隆了远程 Git 存储库,例如从GitHub,远程会自动配置,您无需在想要与其同步时指定它。Git 为您克隆的远程设备提供的默认名称是origin

有关如何共享不同项目格式的项目设置的信息,请参阅通过 VCS 共享项目设置

定义一个遥控器

  1. 在任何 Git 主机上创建一个空存储库,例如BitbucketGitHub。您无需离开 PhpStorm 即可在 GitHub 上创建存储库:请参阅在 GitHub 上共享项目

  2. 当您准备好推送提交时,通过选择 Git |调用推送对话框。从主菜单按 ,或Ctrl+Shift+K

  3. 在打开的对话框中,指定远程名称和托管它的 URL,然后单击OK

添加第二个遥控器

在某些情况下,您还需要添加第二个远程存储库。这可能很有用,例如,如果您克隆了一个您没有写入权限的存储库,并且您要将更改推送到您自己的原始项目分支。另一个常见的情况是,您克隆了自己的存储库,该存储库是其他人的项目分支,您需要与原始项目同步并从中获取更改。

  1. 从主菜单中,选择 Git | 管理遥控器Git 遥控器对话框将打开。

  2. 单击工具栏上的添加 添加按钮或按Alt+Insert

  3. 在打开的对话框中,指定远程名称和 URL,然后单击OK

从此视频了解更多信息:

最后修改:2021 年 12 月 22 日