Mac电脑如何正确安装PyCharm？超详细教程 – wiki基地

Mac电脑PyCharm超详细安装教程（2024最新版）

PyCharm 是一款由 JetBrains 公司开发的强大的 Python 集成开发环境（IDE），深受广大 Python 开发者的喜爱。它提供了代码分析、图形化调试器、集成的单元测试、版本控制集成（Git）以及对各种 Web 开发框架（如 Django、Flask）的支持等众多功能，极大地提高了开发效率。

本教程将详细介绍在 macOS 系统上安装 PyCharm 的完整过程，从下载安装包到配置环境，再到常见问题解答，力求让每一位读者都能顺利完成安装并开始使用 PyCharm 进行 Python 开发。

本教程涵盖以下内容：

1. 准备工作：系统要求与网络环境
2. 下载 PyCharm 安装包
   • 2.1 官方网站下载
   • 2.2 JetBrains Toolbox App 下载（推荐）
3. 安装 PyCharm
   • 3.1 DMG 文件安装
   • 3.2 JetBrains Toolbox App 安装
4. 首次启动与配置
   • 4.1 导入设置（可选）
   • 4.2 用户界面主题选择
   • 4.3 插件安装（可选）
   • 4.4 创建新项目
   • 4.5 配置 Python 解释器
5. PyCharm 常用设置与技巧
   • 5.1 代码风格设置
   • 5.2 快捷键设置
   • 5.3 版本控制集成（Git）
   • 5.4 调试器配置
   • 5.5 虚拟环境配置
6. 常见问题解答（FAQ）
7. 卸载 PyCharm
8. 总结

---

1. 准备工作：系统要求与网络环境

在开始安装 PyCharm 之前，请确保您的 Mac 电脑满足以下最低系统要求：

• macOS 版本： macOS 10.14 或更高版本（建议使用最新版本）。
• 内存（RAM）： 至少 2 GB（建议 8 GB 或更多）。
• 硬盘空间： 至少 2.5 GB（建议 5 GB 或更多，用于缓存和项目文件）。
• 屏幕分辨率： 1024×768 或更高。
• Python 版本： PyCharm 支持 Python 2.7 以及 Python 3.6 至 Python 3.12 的所有主要版本。虽然 PyCharm 可以不依赖预装的 Python 环境，但强烈建议您事先安装好所需的 Python 版本，以便更好地管理项目依赖。您可以从 Python 官网下载安装。

网络环境：

由于需要从互联网下载 PyCharm 安装包，因此您需要一个稳定的网络连接。如果您的网络环境不稳定或速度较慢，可能会导致下载时间过长或下载失败。建议使用宽带连接或 Wi-Fi 网络。

2. 下载 PyCharm 安装包

有两种主要方式可以下载 PyCharm 安装包：

2.1 官方网站下载

1. 访问 JetBrains 官方网站： 打开您的浏览器，访问 PyCharm 官方下载页面：https://www.jetbrains.com/pycharm/download/

2. 选择版本： 您会看到两个版本可供选择：

   • Professional（专业版）： 付费版本，提供对 Web 和科学开发工具的全面支持，包括 Django、Flask、数据库工具、科学计算库等。
   • Community（社区版）： 免费版本，提供基本的 Python 开发功能，如代码编辑、调试、版本控制等。对于初学者或仅进行纯 Python 开发的用户来说，社区版已经足够。

   根据您的需求选择合适的版本。如果您不确定，可以先下载社区版试用。

3. 选择操作系统： 确保选择了 “macOS” 选项。

4. 选择芯片架构：

   • Apple Silicon: 如果你的 Mac 电脑使用的是苹果自研芯片（M1, M2, M3…），请选择这个选项。
   • Intel: 如果你的 Mac 电脑使用的是 Intel 芯片，请选择这个选项。

5. 点击 “Download” 按钮： 开始下载 DMG 安装文件。

2.2 JetBrains Toolbox App 下载（推荐）

JetBrains Toolbox App 是 JetBrains 公司推出的一个用于管理所有 JetBrains IDE 的工具。使用 Toolbox App 安装和更新 PyCharm 非常方便。

1. 下载 JetBrains Toolbox App： 访问 Toolbox App 下载页面：https://www.jetbrains.com/toolbox-app/

2. 安装 Toolbox App： 下载完成后，双击 DMG 文件并按照提示将 Toolbox App 拖动到 “Applications” 文件夹中。

3. 启动 Toolbox App： 在 “Applications” 文件夹中找到 Toolbox App 并启动。

4. 安装 PyCharm： 在 Toolbox App 界面中，找到 PyCharm（Professional 或 Community），点击 “Install” 按钮即可。Toolbox App 会自动下载并安装最新版本的 PyCharm。

两种下载方式的比较：

• 官方网站下载： 简单直接，但每次更新都需要手动下载新的安装包。
• JetBrains Toolbox App： 推荐使用，可以方便地管理多个 JetBrains IDE，自动更新，还可以轻松切换不同版本的 IDE。

3. 安装 PyCharm

根据您选择的下载方式，安装过程略有不同：

3.1 DMG 文件安装

1. 打开 DMG 文件： 下载完成后，双击下载的 DMG 文件。

2. 拖动到 “Applications” 文件夹： 在弹出的窗口中，将 PyCharm 图标拖动到 “Applications” 文件夹中。

3. 启动 PyCharm： 在 “Applications” 文件夹中找到 PyCharm 并双击启动。

4. 安全提示： 首次启动时，macOS 可能会弹出安全提示，询问您是否要打开从互联网下载的应用程序。点击 “Open” 确认。

3.2 JetBrains Toolbox App 安装

如果您使用 Toolbox App 安装，Toolbox App 会自动完成下载和安装过程。您只需要在 Toolbox App 界面中点击 “Install” 按钮，然后等待安装完成即可。安装完成后，您可以在 Toolbox App 中直接点击 “Open” 按钮启动 PyCharm。

4. 首次启动与配置

首次启动 PyCharm 时，您需要进行一些初始配置：

4.1 导入设置（可选）

如果您之前使用过 PyCharm，可以选择导入之前的设置。如果您是第一次使用，选择 “Do not import settings”。

4.2 用户界面主题选择

PyCharm 提供了几种不同的用户界面主题，您可以根据自己的喜好选择。常见的有：

• IntelliJ Light: 经典的浅色主题。
• Darcula: 深色主题，适合在光线较暗的环境下使用。
• macOS Light/Dark: 系统主题。

4.3 插件安装（可选）

PyCharm 提供了丰富的插件来扩展其功能。在初始配置阶段，您可以选择安装一些常用的插件，如：

• Key Promoter X: 快捷键提示插件，可以帮助您学习和记忆 PyCharm 的快捷键。
• Material Theme UI: 提供更多主题选择。
• .ignore: 帮助你管理 .gitignore 文件
• Rainbow Brackets: 为括号添加不同的颜色，方便区分。

当然，您也可以跳过此步骤，在以后需要时再安装插件。

4.4 创建新项目

1. 点击 “Create New Project”： 在欢迎界面上，点击 “Create New Project” 按钮。

2. 选择项目类型： 在左侧面板中选择项目类型。如果您只是进行纯 Python 开发，可以选择 “Pure Python”。如果您需要进行 Web 开发，可以选择相应的框架（如 Django、Flask）。

3. 项目设置：

   • Location： 项目保存的位置。建议选择一个方便您管理的目录。
   • Python Interpreter： 选择您要使用的 Python 解释器。
     • New environment using: 创建一个全新的虚拟环境。推荐选择 Virtualenv
     • Previously configured interpreter: 使用您已经安装好的 Python 解释器.

4.5 配置 Python 解释器

配置 Python 解释器是使用 PyCharm 进行 Python 开发的关键步骤。

创建虚拟环境 (推荐)
1. 选择 New environment using -> Virtualenv
2. Base Interpreter: 选择你需要的 Python 版本.
3. Inherit global site-packages: 如果您希望新环境可以访问系统全局安装的 Python 包，可以勾选此选项。
4. Make available to all projects: 如果您希望所有项目都可以使用这个虚拟环境，可以勾选此选项。

使用已有解释器

1. 选择 Previously configured interpreter。
2. 点击右边的 ... 按钮。
3. 在弹出的窗口里选择您要使用的 Python 解释器路径。 如果没有， 点击 Add Interpreter -> Add Local Interpreter
4. 在弹出的窗口中, 左侧选择 System Interpreter.
5. 在 Interpreter 的下拉菜单中选择您需要的 Python 解释器. 如果列表里没有, 可以手动输入 Python 解释器的路径.

创建项目
完成上述步骤后, 点击 Create 按钮创建项目.

5. PyCharm 常用设置与技巧

PyCharm 提供了丰富的设置选项，您可以根据自己的习惯进行个性化配置。

5.1 代码风格设置

• 路径： PyCharm -> Preferences -> Editor -> Code Style -> Python
• 常用设置：
  • Tab size： 缩进使用的空格数（通常为 4）。
  • Indent： 缩进使用的空格数（通常为 4）。
  • Continuation indent： 连续行的缩进（通常为 8）。
  • Hard wrap at: 强制换行的列数（通常为 80 或 120）。

5.2 快捷键设置

• 路径： PyCharm -> Preferences -> Keymap
• 常用快捷键：
  • Ctrl + Space： 基本代码补全。
  • Ctrl + Shift + Enter： 自动完成语句。
  • Ctrl + Alt + L： 格式化代码。
  • Ctrl + /： 注释/取消注释当前行或选中的代码块。
  • Shift + F6： 重命名变量或函数。
  • Ctrl + B： 跳转到定义。
  • Ctrl + Shift + F： 全局搜索。

您可以根据自己的习惯自定义快捷键。

5.3 版本控制集成（Git）

• 路径： PyCharm -> Preferences -> Version Control -> Git
• 配置：
  • Path to Git executable： Git 可执行文件的路径（通常会自动检测）。
  • SSH executable: 选择使用 Native 或 Built-in。

PyCharm 提供了强大的 Git 集成功能，您可以在 IDE 中直接进行提交、拉取、推送、分支管理等操作。

5.4 调试器配置

• 路径： Run -> Edit Configurations
• 配置：
  • Script path： 要运行的 Python 脚本文件。
  • Python interpreter： 选择要使用的 Python 解释器。
  • Working directory： 脚本运行的工作目录。

PyCharm 的调试器功能非常强大，您可以在代码中设置断点，单步执行，查看变量值，帮助您快速定位和解决问题。

5.5 虚拟环境配置

在项目开发中，强烈建议使用虚拟环境来隔离不同项目的依赖。

• 创建虚拟环境：

  • 使用 venv 模块（Python 3.3 及以上版本）：
    bash
python3 -m venv <虚拟环境名称>
  • 使用 virtualenv 工具：
    bash
virtualenv <虚拟环境名称>

• 激活虚拟环境：
  bash
source <虚拟环境名称>/bin/activate

• 在 PyCharm 中使用虚拟环境：
  在项目设置中选择已创建的虚拟环境作为 Python 解释器。

6. 常见问题解答（FAQ）

1. PyCharm 启动缓慢怎么办？

   • 增加内存： 如果您的 Mac 内存较小，可以尝试增加内存。
   • 禁用不必要的插件： 禁用一些不常用的插件可以提高启动速度。
   • 调整 JVM 参数：
     • 找到 PyCharm 的 vmoptions 文件：
     • 右键点击 PyCharm 图标 -> Show Package Contents -> Contents -> bin -> pycharm.vmoptions (或 pycharm64.vmoptions)。
     • 用文本编辑器打开该文件。
     • 修改 -Xmx 参数来增加 PyCharm 可使用的最大内存（例如，-Xmx4g 表示最大使用 4GB 内存）。
     • 修改 -Xms 参数来设置 PyCharm 启动时初始分配的内存（例如, -Xms1g）。
     • 重要提示： 修改 vmoptions 文件时请务必小心，错误的设置可能会导致 PyCharm 无法启动。

2. PyCharm 无法识别 Python 解释器怎么办？

   • 检查 Python 解释器路径是否正确： 确保在 PyCharm 中配置的 Python 解释器路径是正确的。
   • 重新安装 Python 解释器： 有时重新安装 Python 解释器可以解决问题。
   • 检查环境变量： 确保 Python 解释器的路径已添加到系统的环境变量中。

3. PyCharm 出现 “Cannot start under Java 11…” 错误怎么办？

   • PyCharm 需要运行在Java运行时环境下, 这表示您的 Java 环境设置有问题，通常是因为使用了不兼容的 Java 版本。
   • 确保你的系统安装了 Java, 并且是 PyCharm 支持的版本。
   • PyCharm 通常自带了 JetBrains Runtime，一般不需要单独安装 Java。 除非您需要使用系统级别的 Java。
   • 如果您安装了多个 Java 版本，确保 PyCharm 使用的是正确的版本。

4. PyCharm 无法安装插件怎么办？

   • 检查网络连接： 确保您的网络连接正常。
   • 检查插件市场设置： PyCharm -> Preferences -> Plugins -> Marketplace。
   • 手动安装插件： 从 JetBrains Plugins 网站下载插件的 ZIP 文件，然后在 PyCharm 中选择 “Install Plugin from Disk…” 进行安装。

7. 卸载 PyCharm

如果您需要卸载 PyCharm，可以按照以下步骤操作：

1. 退出 PyCharm： 确保 PyCharm 已经完全退出。
2. 删除应用程序： 将 “Applications” 文件夹中的 PyCharm 应用程序拖动到废纸篓。

3. 删除相关文件（可选）：

   • ~/Library/Application Support/JetBrains/PyCharm<版本号>
   • ~/Library/Caches/JetBrains/PyCharm<版本号>
   • ~/Library/Logs/JetBrains/PyCharm<版本号>
   • ~/Library/Preferences/com.jetbrains.PyCharm.plist
   • ~/Library/Preferences/jetbrains.pycharm.*.plist
   • ~/Library/Saved Application State/com.jetbrains.PyCharm.savedState

   注意： 删除这些文件会清除 PyCharm 的所有设置和缓存，请谨慎操作。

4. 清空废纸篓： 清空废纸篓以彻底删除 PyCharm。

如果您是通过 JetBrains Toolbox App 安装的 PyCharm，可以在 Toolbox App 中直接卸载。

8. 总结

本教程详细介绍了在 macOS 系统上安装 PyCharm 的完整过程，从下载安装包到配置环境，再到常见问题解答，希望能够帮助您顺利安装并开始使用 PyCharm 进行 Python 开发。PyCharm 是一款功能强大的 IDE，熟练掌握它可以大大提高您的开发效率。祝您编程愉快！