【GIt】在PyCharm上安装和使用Git工具

Ne0inhk

— 7 min read
【GIt】在PyCharm上安装和使用Git工具

🧩 1. 准备工作：安装与配置

  • 安装 Git：
    • 确保你已在计算机上安装了 Git。你可以从官方网站下载并安装。
    • 安装完成后，打开终端（或命令提示符）并输入 git --version 来验证安装是否成功。如果成功，会显示类似 git version 2.xx.xx 的信息。
  • 在 PyCharm 中配置 Git：
    • 打开 PyCharm。
    • 转到 File -> Settings (Windows/Linux) 或 PyCharm -> Preferences (macOS)。
    • 在设置窗口中，导航到 Version Control -> Git。
    • 在 Path to Git executable 输入框中，找到并选择你系统上 Git 可执行文件的路径（通常是 git 或 git.exe）。
    • 点击 Test 按钮以确保 PyCharm 可以成功运行 Git。如果配置正确，会显示类似 “Git executed successfully” 和当前 Git 版本的信息。
    • 点击 OK 保存设置。
通常会自动寻找识别git.exe

📂 2. 初始化仓库或克隆现有项目

  • 初始化新的 Git 仓库：
    • 如果你有一个现有项目但还不是 Git 仓库：
      • 打开项目。
      • 转到 VCS -> Enable Version Control Integration...。
      • 在弹出窗口中选择 Git，然后点击 OK。
      • PyCharm 会在项目根目录下创建一个 .git 文件夹（隐藏），并将项目文件标记为待跟踪。
  • 克隆现有的远程仓库：
    • 如果你想从Git EE, GitHub, GitLab 等平台克隆一个项目：
      • 转到 File -> New -> Project from Version Control...。
      • 在 URL 栏输入远程仓库的 URL。
登录方式令牌、密码任选
新建项目的时候勾选上也行。
# 首次拉取远程仓库代码gitadd.git commit -m "Initial commit"git pull origin master 
 * 指定 `Directory`（本地存放路径）。 * 点击 `Clone`。 * PyCharm 会将远程仓库的所有文件和历史记录下载到你指定的本地目录，并自动打开该项目。

🔍 3. 查看文件状态与差异

  • 文件状态颜色：
    • 在项目文件浏览器中，文件会根据其 Git 状态显示不同颜色（可在 Settings -> Version Control -> File Status Colors 中自定义）：
      • 红色： 未被跟踪（Untracked）。
      • 绿色： 新添加到暂存区（Staged）。
      • 蓝色： 已修改但未暂存（Modified）。
      • 无颜色： 已提交且未修改（Committed）。
  • 查看文件差异：
    • 右键点击文件或文件夹 -> Git -> Compare with...。
    • 你可以选择与 Repository version（最后一次提交的版本）、Local Changes（上一次提交后的所有更改）、Branch（其他分支的版本）进行比较。
    • 一个差异查看器会打开，清晰地显示代码行的增删改。

➕ 4. 暂存与提交更改

  • 暂存更改：
    • 修改文件后，它们会变成蓝色（已修改）。
    • 在 Commit 工具窗口（View -> Tool Windows -> Commit 或快捷键 Alt + 0）中，你会看到所有更改的文件列表。
    • 勾选你希望包含在下一次提交中的文件（相当于 git add）。
      • 右键点击文件 -> Add to VCS 也可将其加入暂存区（显示为绿色）。
  • 提交更改：
    • 在 Commit 工具窗口的文本框中，输入有意义的提交信息（Commit Message），清晰描述本次更改的内容。
    • 点击 Commit 按钮（或使用快捷键 Ctrl + K）。
    • 提交后，这些更改将被记录到本地仓库的历史中。

🔄 5. 分支管理

  • 查看当前分支：
    • 当前分支名称显示在 PyCharm 窗口右下角。
  • 创建新分支：
    • 点击右下角的分支名 -> New Branch。
    • 输入新分支名称，点击 OK。PyCharm 会自动切换到新分支。
  • 切换分支：
    • 点击右下角的分支名 -> 选择你想要切换到的分支 -> Checkout。
  • 合并分支：
    • 切换到你想将更改合并到的目标分支（通常是 main 或 master）。
    • 点击右下角的分支名 -> Merge -> 选择你想要合并的来源分支。
  • 解决合并冲突：
    • 如果合并时 Git 无法自动合并文件，会产生冲突。
    • PyCharm 会高亮显示冲突的文件。
    • 双击冲突文件打开合并工具。该工具通常分为三栏：Current changes（当前分支）、Conflicting changes（冲突内容）、Incoming changes（要合并的分支）。
    • 手动选择要保留的更改（点击 >> 或 X），或编辑中间栏解决冲突。
    • 解决完所有冲突后，标记文件为已解决（右键文件 -> Mark Resolved 或点击工具栏按钮）。
    • 最后执行一次提交来完成合并操作。

☁️ 6. 与远程仓库交互

  • 推送更改：
    • 当你提交更改到本地仓库后，需要将它们推送到远程仓库（如 GitHub）。
    • 点击 VCS -> Git -> Push（或使用快捷键 Ctrl + Shift + K）。
    • 在打开的推送对话框中，选择要推送的分支（通常是当前分支），点击 Push。
  • 拉取更改：
    • 从远程仓库获取他人的更改并合并到你的本地分支。
    • 点击 VCS -> Git -> Pull（或使用快捷键 Ctrl + T）。
    • 在打开的拉取对话框中，选择要拉取的远程分支和要合并到的本地分支（通常两者一致），点击 Pull。
  • 查看远程仓库：
    • 在 Git 工具窗口（View -> Tool Windows -> Git）中，选择 Log 标签页，可以查看本地和远程分支的提交历史。
  • 管理远程：
    • 可以在 Settings -> Version Control -> Git -> Remotes 中添加、编辑或删除远程仓库地址。

🔎 7. 查看历史记录与回滚

  • 查看提交历史：
    • 在 Git 工具窗口中选择 Log 标签页。
    • 这里列出了项目所有分支的提交历史，包括提交者、日期、提交信息和哈希值。
    • 右键点击某个提交，可以选择查看该提交的详细信息、差异，或者回滚到该版本。
  • 回滚更改：
    • 回滚未提交的更改：
      • 在编辑器或项目视图中，右键点击文件 -> Git -> Revert。这将丢弃自上次提交以来对该文件的所有修改。
    • 回滚到特定提交：
      • 在 Log 标签页中，右键点击目标提交 -> Reset Current Branch to Here...。
      • 选择重置模式：
        • Soft：只移动 HEAD 指针，不改变索引和工作目录（更改仍在暂存区）。
        • Mixed（默认）：移动 HEAD 指针，重置索引（暂存区），但不改变工作目录（更改仍在工作区）。
        • Hard：移动 HEAD 指针，重置索引和工作目录（丢弃所有未提交的更改）。慎用！
      • 通常选择 Mixed 或 Hard 来回滚代码状态。

📋 8. 忽略文件 (.gitignore)

  • 有些文件（如编译输出文件 .pyc, 虚拟环境目录 venv/, IDE 配置文件 .idea/, 本地配置文件 .env 等）不应该被 Git 跟踪。
  • 在项目根目录创建一个名为 .gitignore 的文件。
  • 保存文件后，PyCharm 会自动应用这些规则，被忽略的文件将显示为灰色（或根据设置的颜色）。

在文件中列出要忽略的文件模式或目录名（每行一个）。例如：

# Python __pycache__/ *.pyc .env # PyCharm .idea/ # Virtual Environments venv/
Could not load content