# 设置 Git 仓库

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

> **TL;DR**
> Git 设置：  `设置 | 版本控制 | Git`
>
>
>
> 必需插件：   Git  （默认捆绑并启用）

当您 [克隆](#clone-repo)现有的 Git 存储库或 [将现有项目置于 Git 版本控制之下](#put-existing-project-under-Git)时，IntelliJ IDEA 会自动检测您的计算机上是否安装了 Git。 如果 IDE 无法找到 Git 可执行文件，它会建议下载。

IntelliJ IDEA 支持适用于 Linux 的 Windows 子系统 2 (WSL2) 中的 Git，该子系统可在 [Windows 10 版本 2004](https://devblogs.microsoft.com/commandline/wsl2-will-be-generally-available-in-windows-10-version-2004/) 中使用。

如果 Windows 上未安装 Git，IntelliJ IDEA 会在 WSL 中搜索 Git 并从那里使用它。 此外，当使用  `\\wsl$`  路径打开项目时，IntelliJ IDEA 会自动切换为使用来自 WSL 的 Git。

如果需要手动配置 IntelliJ IDEA 以使用来自 WSL 的 Git，请转到   版本控制 | Git  设置页面 `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))，点击   浏览  图标，在   Git 可执行文件路径  字段中通过  `\wsl$` 路径选择来自 WSL 的 Git，例如  `\\wsl$\debian\usr\bin\git` 。

## 从远程主机检出项目（git clone）

IntelliJ IDEA 允许您签出（在 Git 术语中，  clone ）一个现有的仓库，并基于您下载的数据创建一个新项目。

Procedure:

1. 要开始克隆 Git 仓库，请执行以下操作之一：

* 如果版本控制集成已经启用，请前往 `Git | 克隆` 。

* 如果版本控制集成尚未启用，请前往 `VCS | 从版本控制获取` 。 或者，转到 `文件 | 新建 | 从版本控制创建项目` 。

* 如果当前没有打开项目，请点击 克隆存储库 在 欢迎 屏幕上。

2. 在   克隆存储库  对话框中，指定您要克隆的远程仓库的 URL 或选择左侧的一个 VCS 托管服务。

如果您已经登录到所选的托管服务，补全将建议可以克隆的可用库列表。

![从 GitHub 获取项目](https://resources.jetbrains.com.cn/help/img/idea/2026.3/get-from-vc-git.png)

如果要执行历史记录有限的 [浅克隆](https://git-scm.com/docs/git-clone#Documentation/git-clone.txt-code--depthcodeemltdepthgtem)，请选择   浅克隆，历史截断为   复选框，并指定要克隆的提交数。

您可以稍后通过在主菜单中选择   Git | 取消浅克隆存储库  来获取其余的历史记录。

3. 点击   克隆  。 如果您想基于克隆的源代码创建项目，请在确认对话框中点击   是  。 Git 根映射将自动设置为项目根目录。

如果您的项目包含 [submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules)，它们也将被克隆并自动注册为项目根目录。

4. 在   信任并打开项目 '<project_name>'？   [项目安全对话框](project-security.html)中，选择您想要打开项目的方式：   信任项目  或   在安全模式中预览  。

5. 首次导入或克隆项目时，IntelliJ IDEA 会对其进行分析。 如果 IDE 检测到多个配置（例如，Eclipse 和 Gradle），它会提示您选择要使用的配置。

> **Note:**
> 如果要导入的项目使用构建工具，例如 [Maven](maven-support.html) 或 [Gradle](gradle.html)，建议选择构建工具配置。

选择所需的配置并点击   OK  。

IDE 将根据您的选择对项目进行预配置。 例如，如果选择   Gradle  ，IntelliJ IDEA 将执行其构建脚本、加载依赖项等。

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

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

Procedure: 将整个 project 关联到单个 Git 存储库

1. 打开您希望置于 Git 之下的 project。

2. 按 `Alt+`` (Windows), `⌃ V` (macOS), `⌃ V` (IntelliJ IDEA Classic (macOS)), `⌃ C` (macOS System Shortcuts), `Alt+`` (XWin), `Alt+`` (GNOME), `Alt+`` (KDE), `Alt+`` (Emacs), `Alt+`` (Sublime Text), `Alt+`` (Sublime Text (macOS)), `Ctrl+Alt+Q` (Visual Studio), `⌃ V` (Visual Studio (macOS)), `Alt+`` (NetBeans), `Alt+`` (Eclipse), `⌃ V` (Eclipse (macOS)) 打开   VCS 操作弹出窗口   并选择   启用版本控制集成  。

或者，转到  `VCS | 启用版本控制集成` 。

3. 选择   Git   作为版本控制系统，然后点击   OK  。

整个项目随后将与单个 Git 目录关联。 之后， [添加您希望由 Git 跟踪的文件](#add-new-files)到本地存储库。

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

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

> **Note:**
> 如果在   VCS 操作弹出窗口   中没有   启用版本控制集成   选项，这意味着已经为该项目启用了 Git 版本控制。

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

1. 打开您想要放入 Git 的目录。

2. 在主菜单中，前往  `VCS | 创建 Git 仓库` 。

3. 在打开的对话框中，指定将创建新 Git 仓库的目录。

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

4. 如果您在 project 结构中创建多个 Git 仓库，请对每个目录重复上述步骤。

在您为项目 [初始化了一个 Git 仓库](#put-existing-project-under-Git)之后，您需要将项目文件添加到仓库中。

Procedure: 将文件添加到本地仓库

1. 在   提交   工具窗口（ `Alt+0` (Windows), `⌘ 0` (macOS), `⌘ 0` (IntelliJ IDEA Classic (macOS)), `⌘ 0` (macOS System Shortcuts), `Alt+0` (XWin), `Alt+0` (GNOME), `Alt+0` (KDE), `Alt+0` (Emacs), `Alt+0` (Sublime Text), `⌘ 0` (Sublime Text (macOS)), `Alt+0` (Visual Studio), `Alt+0` (Visual Studio (macOS)), `Alt+0` (NetBeans), `Alt+0` (Eclipse), `⌘ 0` (Eclipse (macOS))）中，展开   未受版本控制的文件   节点。

2. 选择您要添加到 Git 的文件或整个变更列表，然后按 `Ctrl+Alt+A` (Windows), `⌘ ⌥ A` (macOS), `⌘ ⌥ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ A` (macOS System Shortcuts), `Ctrl+Alt+A` (XWin), `Ctrl+Alt+A` (GNOME), `Ctrl+Alt+A` (KDE), `Ctrl+Alt+A` (Emacs), `Ctrl+Alt+A` (Sublime Text), `⌘ ⌥ A` (Sublime Text (macOS)), `Ctrl+Alt+A` (Visual Studio), `⌘ ⌥ A` (Visual Studio (macOS)), `Ctrl+Alt+A` (NetBeans), `Ctrl+Alt+A` (Eclipse), `⌘ ⌥ A` (Eclipse (macOS)) 或从上下文菜单中选择   添加到 VCS  。

还可以从   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）将文件添加到本地 Git 仓库：选择要添加的文件，然后按 `Ctrl+Alt+A` (Windows), `⌘ ⌥ A` (macOS), `⌘ ⌥ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ A` (macOS System Shortcuts), `Ctrl+Alt+A` (XWin), `Ctrl+Alt+A` (GNOME), `Ctrl+Alt+A` (KDE), `Ctrl+Alt+A` (Emacs), `Ctrl+Alt+A` (Sublime Text), `⌘ ⌥ A` (Sublime Text (macOS)), `Ctrl+Alt+A` (Visual Studio), `⌘ ⌥ A` (Visual Studio (macOS)), `Ctrl+Alt+A` (NetBeans), `Ctrl+Alt+A` (Eclipse), `⌘ ⌥ A` (Eclipse (macOS)) 或从上下文菜单中选择   Git | 添加  。

当 Git 集成在您的 project 中启用时，IntelliJ IDEA 建议将每个新增文件添加到 Git，即使它是从 IntelliJ IDEA 外部添加的。 您可以在   版本控制 | 确认  设置页面 `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))中更改此行为。 如果您希望某些文件始终保持未版本化，您可以 [忽略它们](#ignore-files)。

> **Note:**
> 如果您尝试添加位于  `.gitignore` 列表中的文件，IntelliJ IDEA 将建议强制添加它。 点击确认对话框中的   取消   仅取消强制添加已忽略的文件——所有其他文件将会添加到 Git 仓库。

## 将文件排除在版本控制之外（忽略）

有时您可能需要保持某些文件不进行版本控制。 这些可以是 VCS 管理文件、实用工具的工件、备份副本等。 您可以通过 IntelliJ IDEA 忽略文件，IDE 将不会建议将它们添加到 Git，并会将它们高亮显示为已忽略。

您只能忽略  unversioned 文件，也就是说，您在   未受版本控制的文件  更改列表中看到的文件。 如果某个文件已 [添加到 Git](#add-new-files)但尚未 [提交](commit-and-push-changes.html)，您可以在   提交   窗口中右键点击它并选择   回滚  。

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

* `.git/info/exclude` 文件。 此文件中列出的模式仅适用于仓库的本地副本。 此文件会在您初始化或检出 Git 仓库时自动创建。

* 一个或多个 `.gitignore` 文件在 VCS 根目录及其子目录中。 这些文件被检入仓库，以便整个团队都能使用其中的忽略模式。 因此，这是存储忽略文件模式的最常见位置。 如果 VCS 根目录中没有 `.gitignore` 文件，您可以在 项目 工具窗口中的任意位置右键点击，选择 `新建 | 文件` ，并在 新建文件 对话框中键入 `.gitignore` 。 > **Tip:** > 在 Windows 资源管理器中创建一个 `.gitignore` 文件，创建一个名为 `.gitignore.` 的文件，Windows 会自动将其重命名为 `.gitignore` 。

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

1. 决定要使用哪种 [Git 配置文件](#add-gitignore) 来忽略文件。 如有疑问，请使用  `.gitignore` 。

2. 在   提交   窗口或   项目   工具窗口（ `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS))）中，找到要忽略的未受版本控制的文件或文件夹。 [这些视图中的文件颜色](adding-files-to-version-control.html#file_status)有助于识别文件状态。

3. 右键点击选择内容，然后选择   Git | 添加到 .gitignore   或   Git | 添加到 .git/info/exclude  。

[这些视图中的文件颜色](adding-files-to-version-control.html#file_status)帮助您识别文件的状态。

如果您需要按特定模式或类型排除文件，您可以直接编辑  `.gitignore`  或  `.git/info/exclude`  文件。 请参阅 [.gitignore patterns format](https://git-scm.com/docs/gitignore?origin_team=T0288D531)。

> **Tip:**
> 如果您希望 [已忽略的文件](#ignore-files)也显示在   提交   窗口中，请在工具栏上点击 ![眼睛图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.actions.show.svg)，然后选择   显示已忽略的文件  。

## 添加远程仓库

如果您基于本地源 [创建了一个 Git 仓库](#put-existing-project-under-Git)，您需要添加一个远程仓库，才能协作完成 Git 项目，并消除仅在本地存储整个代码库的风险。 当您需要分享您的工作时，您向远程仓库 [push](commit-and-push-changes.html#push)更改，并从中 [pull](sync-with-a-remote-repository.html#pull)数据，将其他贡献者所做的更改合并到您的本地仓库版本中。

如果您 [克隆了远程 Git 仓库](#clone-repo)，例如从 [GitHub](https://github.com/)，远程仓库会自动配置。要与其 [同步](sync-with-a-remote-repository.html) 时，您无需指定它。 Git 赋予您克隆自远程仓库的默认名称是  origin 。

有关为不同项目格式共享项目设置的更多信息，请参阅 [通过 VCS 共享项目设置](configure-project-settings.html#share-project-through-vcs)。

Procedure: 定义远程仓库

1. 在任意 Git 托管平台（例如 [Bitbucket](https://bitbucket.org/)、 [GitHub](https://github.com/) 或 [GitLab](https://about.gitlab.com/)）上创建一个空存储库。 您无需离开 IntelliJ IDEA 即可在 GitHub 或 GitLab 上创建存储库：请参阅 [在 GitHub 上共享项目](manage-projects-hosted-on-github.html#share-on-GitHub) 和 [在 GitLab 上共享项目](clone-gitlab-project.html#share-a-project-on-gitlab)。

2. 当您准备好推送提交时，通过从主菜单中选择  `Git | 推送` 或按 `Ctrl+Shift+K` (Windows), `⌘ ⇧ K` (macOS), `⌘ ⇧ K` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ K` (macOS System Shortcuts), `Ctrl+Shift+K` (XWin), `Ctrl+Shift+K` (GNOME), `Ctrl+Shift+K` (KDE), `Ctrl+Shift+K` (Emacs), `Ctrl+Shift+K` (Sublime Text), `⌘ ⇧ K` (Sublime Text (macOS)), `Ctrl+Shift+K` (Visual Studio), `⌘ ⇧ K` (Visual Studio (macOS)), `Ctrl+Shift+K` (NetBeans), `Ctrl+Shift+K` (Eclipse), `⌘ ⇧ K` (Eclipse (macOS))来调用   推送  对话框。

3. 如果您还没有添加任何 remote ，   定义远程  链接将显示在远程名称的位置。 点击它以添加远程。

4. 在打开的对话框中，指定远程名称和用于托管它的 URL。

选择   提取远程   选项，以便立即 [获取](sync-with-a-remote-repository.html#fetch)分支列表和提交历史。

Procedure: 添加第二个远程库

在某些情况下，您还需要添加第二个远程仓库。 例如，如果您克隆了一个没有写权限的存储库，并打算将更改推送到您自己的原始项目 [fork](fork-github-projects.html#fork)中，这可能会很有用。 另一种常见的情况是，您已经克隆了自己的代码库，而这个代码库是别人的项目分支，您需要与原始项目同步并从中获取更改。

1. 在主菜单中，转到  `Git | 管理远程` 。   Git 远程库   对话框将打开。

2. 请点击工具栏上的   添加   ![添加](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg) 按钮或按 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))。

3. 在打开的对话框中，指定 remote 名称和 URL，然后点击   OK  。

* 要编辑一个远程（例如，更改您克隆的原始项目的名称），请在 [Git Log 工具窗口的分支窗格](log-tab.html#BranchesPane)中右键点击远程分支，然后从上下文菜单中选择 编辑远程 。 您还可以通过点击名称从 [Push Dialog](commit-and-push-changes.html#push) 编辑远程。

* 要删除无效的存储库，请在 [Git 日志工具窗口的分支窗格](log-tab.html#BranchesPane) 中右键点击它，并从上下文菜单中选择 移除 Remote 。

从此视频中了解更多信息：

[Video](https://www.youtube.com/v/lyiBnyPPnG4)

## 为 Git 远程仓库设置密码

每次与远程 Git 仓库交互时（例如，在 [pull](sync-with-a-remote-repository.html#pull)、 [update](sync-with-a-remote-repository.html#update)或 [push](commit-and-push-changes.html)操作期间），都需要授权。 您可以 [配置 IntelliJ IDEA 记住您的密码](#password-policy)，这样每次需要授权时，您就不必输入凭据。

Procedure: 配置密码策略

1. 在   设置  对话框 `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))中，选择左侧的   外观与行为 | 系统设置 | 密码  。

2. 选择您希望 IntelliJ IDEA 如何处理 Git 远程存储库的密码：

* 在本地 Keychain ：选择此选项以使用原生 Keychain 存储您的密码。 此设置仅适用于 macOS 和 Linux。

* 在 KeePass ：选择此选项以使用 [KeePass 密码管理器](http://keepass.info/)来存储您的密码。 当您使用 KeePass 密码管理器 时，将使用主密码来访问存储单个密码的文件。 一旦 IntelliJ IDEA 记住您的密码，除非您需要访问密码数据库，否则不会再询问。 请输入将用于访问 `c.kdbx` 文件的密码到 主密码 字段中。 您可以在 数据库 字段中更改 `c.kdbx` 文件的默认位置。 要导入 `c.kdbx` 文件，请点击 !["设置"图标](https://resources.jetbrains.com.cn/help/img/idea/2026.3/icon_viewMode.png) 并从下拉菜单中选择 导入 ，或者点击 ![浏览按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.general.ellipsis.svg) 并指定包含您密码的本地文件路径。 如果您想从数据库中删除现有密码，请选择 清除 。

* 不保存，重启后忘记密码 ：如果您希望在关闭 IntelliJ IDEA 后重置您的密码，请选择此选项。

## See also

### 外部链接

[Stack Overflow: When would you use .git/info/exclude instead of .gitignore to exclude files?](https://stackoverflow.com/questions/22906851/when-would-you-use-git-info-exclude-instead-of-gitignore-to-exclude-files) [JetBrains.gitignore on GitHub](https://github.com/github/gitignore/blob/master/Global/JetBrains.gitignore)