# 项目设置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

项目设置仅适用于当前项目。 它们与其他项目文件一起以  `.xml`  格式存储在  `.idea`  目录中。 项目设置可以包括 VCS 配置、代码风格选项、语言检查列表和其他设置。

您可以从主菜单中选择  `%instance% | 设置` （在 macOS 上），或  `文件 | 设置` （在 Windows 和 Linux 上），以配置项目设置。 或者，您可以按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 显示 IDE 设置。

在   设置  对话框中，仅适用于当前项目的项目设置将标记为 ![项目设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.projectConfigurable.svg)图标。 其他设置是 [global](configuring-project-and-ide-settings.html)的，并适用于所有现有项目。

![设置对话框](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sett-pref-dialog.png)

有关每个设置选项的详细说明，请参阅 [设置](settings-preferences-dialog.html)。

## 新项目的默认设置

您不仅可以为当前项目配置项目设置，还可以为以后创建的所有项目配置。 这意味着您可以为您的项目设置新的默认设置。

Procedure: 在新项目中访问默认设置

* 在主菜单中，前往  `文件 | 新建项目设置 | 新项目的 设置` 。

如果您希望在现有项目之间共享项目设置，您可以使用 [Backup and Sync](sharing-your-ide-settings.html#IDE_settings_sync) 插件。 您还可以 [将设置导出到 ZIP 存档](sharing-your-ide-settings.html#import-export-settings)，并稍后将其导入到其他 IDE 实例。

## 通过 VCS 共享项目设置

> **Warning:**
> 此信息适用于 Git 和 Mercurial。 如果您使用其他版本控制系统，请参阅 [如何在版本控制系统中管理项目](https://intellij-support.jetbrains.com/hc/en-us/articles/206544839)，了解如何手动共享项目。

项目设置存储在项目目录中的  `.idea`  文件夹下的一组 XML 文件中。 该文件夹同时包含不应放入版本控制中的用户专属设置和通常在团队开发者之间共享的项目设置，例如代码样式配置。

当您 [在项目中启用版本控制](enabling-version-control.html#associate_directory_with_VCS)时，IntelliJ IDEA 会自动将包含您个人设置的  `workspace.xml` 文件移至  .gitignore 列表，以避免与其他开发者的设置发生冲突。

> **Warning:**
> 如果使用 [Git 工作区](use-git-worktrees.html)并且已经提交了  `.idea/workspace.xml` ，则需要从新创建的 Git 工作区中删除此文件（或移除其中的  `ProjectId` ），然后重新打开项目以避免 IDE 冲突。

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

* 查看文件 ：查看已创建的配置文件列表，并选择您要置于版本控制的文件。 之后，选定的文件将被安排添加到 VCS。

* 始终添加 ：将 `.idea` 目录中创建的所有配置文件默默地安排添加到 VCS（仅适用于当前项目）。

* 不再询问 ：切勿将配置文件安排添加到 VCS；它们将保持 未版本化 状态，直到您手动将其添加到 VCS（仅适用于当前项目）。

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

![提示选择如何处理配置文件的通知](https://resources.jetbrains.com.cn/help/img/idea/2026.3/sharing-project-notification.png)

> **Note:**
> 如果  `misc.xml`  或  `.ipr`  文件已在版本控制之下，项目配置文件将被静默地安排添加到 VCS。

### 非共享配置文件列表

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

* `.idea/workspace.xml`

* `.idea/usage.statistics.xml`

* `.idea/dictionaries` 文件夹

* `.idea/shelf` 文件夹

* `.idea/libraries` 如果它们是从 Gradle 和 Maven 项目生成的

* `*.iml` 和 `.idea/modules.xml` 文件在 Maven 和 Gradle 项目里

* `gradle.xml`

* `*.iws` 基于文件的项目中的文件

* `out` 文件夹

要查看完整的文件列表，请参阅 [如何在版本控制系统下管理项目](https://intellij-support.jetbrains.com/hc/en-us/articles/206544839)和 [JetBrains.gitignore](https://github.com/github/gitignore/blob/master/Global/JetBrains.gitignore)。

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

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

不过，某些设置可以复制到项目级别。 例如，您可以创建一个 [代码样式配置](configuring-code-style.html#create-copy) 、 [检查配置文件](customizing-profiles.html)以及 [从代码补全和自动导入中排除的类和包的列表](creating-and-optimizing-imports.html#exclude-from-auto-import) 的副本。 如果您这样做，IDE 会在  `.idea` 目录中创建相应的配置文件，您可以通过 VCS 与项目一起共享这些文件。

IntelliJ IDEA 还提供了几种在不同 IDE 实例之间共享设置的方法。 有关更多信息，请参见 [IDE 设置备份与同步](sharing-your-ide-settings.html)。