PhpStorm 2025.2 Help

创建和管理项目

无论您在 PhpStorm 中做什么,都是在项目的上下文中进行的。 项目是表示完整软件解决方案的组织单元。 它是代码辅助、大规模重构、代码风格一致性等功能的基础。

PhpStorm 中的项目以 基于目录的格式表示。 根项目目录包含 .idea 目录,其中包含以下文件:

  • .iml 文件描述了项目结构。

  • workspace.xml 文件包含您的工作区首选项。

  • 若干 xml 文件。 每个 xml 文件负责其自己的设置集,可以通过其名称识别: projectCodeStyle.xml encodings.xml vcs.xml 等。

    例如,添加新的运行/调试配置和更改编码将影响两个不同的 xml 文件。 这有助于避免当项目设置存储在版本控制系统中并由不同团队成员修改时的合并冲突。

.idea 目录在 Project 视图的 项目工具窗口 Alt+1 中不可见。

通过 VCS 共享项目设置

项目设置存储在项目目录中的 .idea 文件夹下的一组 XML 文件中。 此文件夹包含不应置于版本控制下的用户特定设置和通常在团队开发人员之间共享的项目设置,例如代码样式配置。

当您 在项目中启用版本控制时,PhpStorm 会自动将包含您个人设置的 workspace.xml 文件移至 .gitignore列表,以避免与其他开发者的设置发生冲突。

配置文件根据您的选择进行处理。 一旦您修改了项目设置并创建了一个新的配置文件,IDE 会在屏幕底部显示一个通知提示您选择如何处理此项目中的配置文件:

  • 查看文件 :查看已创建的配置文件列表,并选择您希望置于版本控制下的文件。 之后,选定的文件将被安排添加到 VCS。

  • 始终添加 :将 .idea 目录中创建的所有配置文件默默地安排添加到 VCS(仅适用于当前项目)。

  • 不再询问 :切勿将配置文件安排添加到 VCS;它们将保持 未版本化状态,直到您手动将其添加到 VCS(仅适用于当前项目)。

如果您在没有选择任何选项的情况下关闭通知,那么在创建新的配置文件后,它将再次出现。 新文件也会加入列表中,即使您重启 IDE,该列表仍会保留,直到您选择其中一个选项。

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

非共享配置文件列表

PhpStorm 会识别配置文件,并自动将其添加到忽略文件列表中。 但是,如果您手动共享您的项目,我们建议您避免将这些文件和文件夹置于版本控制之下:

  • .idea/workspace.xml

  • .idea/usage.statistics.xml

  • .idea/dictionaries 文件夹

  • .idea/shelf 文件夹

要查看完整的文件列表,请参阅 如何在版本控制系统下管理项目JetBrains.gitignore

将全局设置复制到项目级别

全局 (IDE) 设置与项目分开存储。 这就是为什么这些设置不会与项目一起通过版本控制共享。

不过,某些设置可以复制到项目级别。 例如,您可以创建您的 检查配置文件的副本。 如果您这样做,IDE 会在 .idea 目录中创建相应的配置文件,您可以通过 VCS 与项目一起共享这些文件。

PhpStorm 还提供了几种在不同 IDE 实例之间共享设置的方法。 有关更多信息,请参见 IDE 设置备份与同步

一旦您在 PhpStorm 中打开一个文件夹, .idea 子文件夹将被添加到其中,PhpStorm 会在其中存储其内部配置设置,例如项目代码风格或版本控制系统。

最后修改日期: 2025年 9月 26日