如何在 Mac 上安装和配置 Pycharm – wiki基地

在 Mac 上安装和配置 PyCharm：一份全面指南

PyCharm 是 JetBrains 公司开发的一款功能强大、专为 Python 开发设计的集成开发环境 (IDE)。无论您是 Python 初学者还是经验丰富的开发者，PyCharm 都能提供智能代码编辑、强大的调试工具、内置的版本控制集成、科学工具支持、Web 开发框架支持等一系列强大功能，极大地提升开发效率和代码质量。

对于 Mac 用户来说，PyCharm 的安装和配置过程通常非常顺畅，但了解其中的细节和关键配置步骤，尤其是关于 Python 解释器和虚拟环境的设置，对于构建一个高效、整洁的开发环境至关重要。

本文将为您提供一份详细的指南，从下载到基础配置，手把手教您如何在 Mac 上安装并初步配置 PyCharm。我们将深入探讨关键的配置项，帮助您快速上手，并为未来的 Python 项目打下坚实的基础。

第一部分：PyCharm 的选择与下载

在开始安装之前，您需要决定使用哪个版本的 PyCharm，并将其下载到您的 Mac 上。PyCharm 主要有两个版本：

PyCharm Community Edition (社区版): 这是免费、开源的版本。它提供了 Python 开发所需的核心功能，如智能代码编辑、语法高亮、调试器、运行器、单元测试集成等。对于大多数个人开发者、学生和非专业的 Python 项目来说，社区版已经足够强大。
PyCharm Professional Edition (专业版): 这是一个付费版本，提供更全面的功能，包括对科学工具（如 NumPy, Matplotlib）、Web 开发框架（如 Django, Flask, Pyramid）、数据库工具、远程开发、Docker、Kubernetes、性能分析等的高级支持。如果您进行 Web 开发、数据科学、企业级应用开发或需要远程调试等功能，专业版将是更好的选择。通常提供免费试用期。

下载步骤：

访问 JetBrains 官方网站: 打开您的 Web 浏览器，前往 PyCharm 的官方下载页面：https://www.jetbrains.com/pycharm/download/
选择您的操作系统: 网站会自动检测您的操作系统，并显示 macOS 的下载选项。确保选择的是 macOS 版本。
选择版本: 在 macOS 部分，您会看到 Professional 和 Community 两个选项。点击您希望下载的版本旁边的 .dmg 按钮开始下载。.dmg 文件是 Mac 上的磁盘镜像文件，包含了应用程序的安装程序。
等待下载完成: 文件大小通常在几百兆到一千兆字节之间，下载时间取决于您的网络速度。下载完成后，您会在浏览器的下载列表或您设置的下载目录中找到一个名为 pycharm-community-YYYY.R.dmg 或 pycharm-professional-YYYY.R.dmg 的文件（YYYY.R 代表版本号）。

第二部分：在 Mac 上安装 PyCharm

下载 .dmg 文件后，安装过程非常简单。

打开 .dmg 文件: 双击您下载的 .dmg 文件。macOS 会挂载这个磁盘镜像，并在 Finder 中打开一个新窗口，显示其中的内容。您会看到 PyCharm 的应用程序图标和一个 Applications 文件夹的快捷方式。
将 PyCharm 应用程序拖入 Applications 文件夹: 选中 PyCharm 的应用程序图标（它看起来像一个蓝色的代码编辑器图标），然后将其拖动到窗口中的 Applications 文件夹快捷方式上。或者，您也可以打开一个新的 Finder 窗口，导航到 /Applications 目录，然后将 PyCharm 图标拖到那里。这个过程会将 PyCharm 应用程序复制到您的应用程序目录中。
等待复制完成: 文件复制过程可能需要一些时间。
弹出磁盘镜像 (可选但推荐): 复制完成后，您可以将桌面或 Finder 侧边栏中显示的 PyCharm 磁盘镜像图标拖到废纸篓中（它会变成弹出图标，而不是删除），或者右键点击它选择“弹出”，以卸载该虚拟磁盘。

现在，PyCharm 应用程序已经成功安装到了您的 Mac 上，位于 /Applications 目录中。

第三部分：首次启动与初始配置

首次启动 PyCharm 时，您需要进行一些基本的配置。

打开 PyCharm:
- 前往您的 /Applications 目录，找到 PyCharm 图标，双击打开。
- 或者，按下 Command + Space 打开 Spotlight 搜索，输入 “PyCharm”，然后按回车键。
安全性提示: 由于 PyCharm 是从互联网下载的，macOS 的 Gatekeeper 功能可能会阻止其直接运行，并显示一个警告窗口，询问您是否确定要打开它。点击 “打开” 或 “Open”。
隐私政策和用户协议: 首次启动 PyCharm 时，您需要阅读并接受 JetBrains 的隐私政策和用户协议。勾选同意框，然后点击 “Accept”。
数据共享同意书 (可选): 接下来，您可以选择是否同意向 JetBrains 发送匿名使用数据以帮助改进产品。这是可选的，根据您的偏好选择 “Send Usage Statistics” 或 “Don’t Send”。
导入设置: 如果您之前安装过 PyCharm 或其他 JetBrains IDE，它可能会询问您是否要导入先前的设置。如果您是首次安装，或者希望从头开始配置，选择 “Do not import settings”，然后点击 “OK”。
激活 PyCharm (仅专业版): 如果您安装的是专业版，您会看到一个激活窗口。您有几种选择：
- Login to JetBrains Account: 使用您的 JetBrains 账户登录，如果您的账户已关联许可证。
- Activation Code: 输入您的激活码。
- License Server: 连接到许可证服务器（通常用于企业环境）。
- Evaluate for free: 开始一个免费试用期（通常为 30 天）。
- 如果您之前下载了社区版，或者现在想使用社区版，通常在这里会有一个选项或直接进入下一步。如果您不确定，并且是首次使用，推荐选择“Evaluate for free”来体验专业版功能，或确保您下载并启动的是社区版。
选择 UI 主题: 您可以选择 PyCharm 的用户界面主题，通常是 Darcula（暗色主题，对眼睛比较友好）或 Light（亮色主题）。选择您喜欢的主题，您之后可以在设置中更改它。
Featured Plugins (特色插件): PyCharm 会推荐一些常用的插件，如版本控制 (Git)、Docker、特定框架支持等。您可以选择安装推荐的插件，或者点击 “Start using PyCharm” 先跳过这一步，稍后在设置中安装需要的插件。对于初学者，先跳过或只安装 Git 相关的插件通常是比较好的选择。

完成这些步骤后，PyCharm 的欢迎界面就会出现。

第四部分：创建您的第一个 Python 项目与配置解释器

成功启动 PyCharm 后，您将看到欢迎界面。从这里，您可以创建新项目、打开现有项目或从版本控制系统获取项目。

创建新项目：

在欢迎界面，点击 “New Project”。
会弹出一个“New Project”窗口。
Location (项目位置): 指定您的项目在文件系统中的存储路径。PyCharm 会默认在用户目录下创建一个 PycharmProjects 文件夹，并在其中创建一个子文件夹作为您的项目目录。您可以点击文件夹图标更改路径。
Project Name (项目名称): 输入您的项目名称，例如 MyFirstPythonProject。PyCharm 会自动更新 Location 字段，在指定路径下创建同名文件夹。
Main content root: 这是项目的主要根目录，通常与项目文件夹相同。
Python Interpreter (Python 解释器): 这是创建新项目时 最重要 的配置项。您需要告诉 PyCharm 使用哪个 Python 版本以及在何种环境下运行您的代码。
- 理解 Python 解释器和虚拟环境:
  - Python 解释器: 这是一个程序，负责读取您的 Python 代码（.py 文件）并执行它们。您的 Mac 上可能安装了多个 Python 版本（例如系统自带的 Python 2.x/3.x，通过 Homebrew 安装的 Python 3.x，通过 python.org 安装的 Python 3.x 等）。
  - 虚拟环境 (Virtual Environment): 虚拟环境是一个独立、隔离的 Python 运行环境。它包含一个特定版本的 Python 解释器以及一套在该环境中安装的库（packages）。强烈建议 为每个项目创建一个独立的虚拟环境。这样做的好处是：
    - 依赖隔离: 不同项目可能依赖不同版本的同一个库。虚拟环境可以确保项目 A 使用库 X 的版本 1.0，而项目 B 使用库 X 的版本 2.0，互不干扰。
    - 环境整洁: 避免在全局 Python 环境中安装大量项目特定的库，保持全局环境干净。
    - 项目可移植性: 通过记录虚拟环境中安装的库及其版本（例如在 requirements.txt 文件中），可以轻松地在其他机器上重建完全相同的开发环境。
- 配置解释器选项: 在“New Project”窗口的“Python Interpreter”部分，您会看到几个选项：
  - New environment using: 这是创建新虚拟环境的选项。PyCharm 支持多种虚拟环境工具：
    - venv: 这是 Python 3.3+ 内置的标准虚拟环境创建工具，轻量且易于使用。对于大多数新项目，推荐使用 venv。
    - Conda: Anaconda/Miniconda 发行版附带的环境管理器，常用于数据科学和机器学习项目。
    - Pipenv: 结合了 Pip 和 Virtualenv 功能的工具，提供更高级的依赖管理。
    - Poetry: 另一个更现代的 Python 依赖管理和打包工具。
  - Previously configured interpreter: 如果您已经创建了虚拟环境（手动创建或通过 PyCharm 为其他项目创建）或想使用系统全局解释器（不推荐），可以选择此选项。
- 使用 venv 创建新环境 (推荐):
  - 选择 “New environment using”，然后选择 “venv”。
  - Location: 指定新虚拟环境的存放位置。默认情况下，PyCharm 会在项目文件夹内创建一个名为 venv（或 .venv）的隐藏文件夹。这是推荐的做法，将环境与项目绑定。
  - Base interpreter: 点击右侧的下拉菜单或文件夹图标，选择用于创建此虚拟环境的“基础”Python 解释器。PyCharm 会尝试查找您系统上已安装的 Python 版本。选择一个您希望使用的 Python 版本（例如 Python 3.9, 3.10, 3.11 等）。如果列表中没有您想要的 Python 版本，您可能需要先在系统上安装它（例如通过 Homebrew 安装 brew install [email protected]，或者从 python.org 下载安装器）。
  - Inherit global site-packages (不推荐勾选): 如果勾选，新创建的环境会继承全局 Python 环境中已经安装的所有库。通常不建议这样做，因为它破坏了虚拟环境的隔离性。
  - Make available to all projects (不推荐勾选): 如果勾选，这个虚拟环境将出现在所有项目的“Previously configured interpreter”列表中。对于项目特定的环境，不建议这样做。
  - 保持默认设置（venv 在项目目录内，不继承全局库，不全局可用）通常是最好的选择。
- 使用已有的解释器:
  - 选择 “Previously configured interpreter”。
  - 点击右侧的下拉菜单，选择您之前配置过的解释器。
  - 如果列表中没有您想要的解释器，点击下拉菜单底部的 “Add Interpreter…”。
  - 在弹出的窗口中，选择 “Virtual Environment”，然后选择 “Existing”。点击文件夹图标，浏览到您现有虚拟环境的根目录（通常是包含 bin/python 的父目录）。
  - 或者，如果您想使用系统全局解释器（再次强调：不推荐），选择 “System Interpreter”，然后从列表中选择一个。
附加设置: 在“New Project”窗口底部，可能会有一些额外的选项，例如创建 main.py 脚本等。通常可以保持默认。
点击 Create: 配置好项目名称、位置和最重要的 Python 解释器后，点击右下角的 “Create” 按钮。

PyCharm 会创建项目目录和配置的虚拟环境（如果选择了新建）。第一次创建虚拟环境可能需要一些时间。创建完成后，PyCharm 会打开项目窗口。

第五部分：PyCharm 工作区概览与基本配置

项目打开后，您会看到 PyCharm 的主工作区。了解其主要区域有助于您更高效地使用它：

Project Window (项目窗口): 通常在左侧。显示项目的文件和目录结构。您可以在这里浏览、打开、创建、重命名和删除文件。
Editor (编辑器): 中间最大的区域。您在这里编写和阅读代码。PyCharm 提供了强大的代码高亮、自动完成、代码检查和重构功能。
Tool Windows (工具窗口): IDE 底部和侧边提供了各种工具窗口，如：
- Terminal: 内置的命令行终端，您可以在这里执行系统命令、运行 Python 脚本、安装库等。
- Python Packages (或 Packages): 管理当前虚拟环境中安装的 Python 库。
- Run: 显示程序运行的输出。
- Debug: 用于调试程序，设置断点、查看变量值、单步执行等。
- Version Control: 集成 Git 等版本控制系统。
- Python Console: 一个交互式的 Python Shell。

基础配置与定制：

要访问 PyCharm 的设置（或偏好设置），请点击菜单栏的 PyCharm -> Settings... (或 Preferences...，取决于 macOS 版本)。这将打开一个 Settings 窗口，您可以在左侧的树状结构中导航到各种配置项。

以下是一些您可能希望立即配置的关键设置：

Appearance & Behavior (外观与行为):
- Appearance:
  - Theme: 在这里您可以更改 PyCharm 的整体外观主题（Light 或 Darcula，以及更多下载的主题）。
  - Sync with OS: 可以让 PyCharm 的主题跟随 macOS 的亮/暗模式切换。
  - Font: 设置 IDE 界面元素的字体和大小。
- System Settings:
  - Startup/Shutdown: 配置启动行为，例如是否自动打开上次的项目。
- Editor Tabs: 配置编辑器中文件标签页的行为，例如位置、关闭按钮、最大标签页数量等。
Editor (编辑器): 这是最常用的配置区域之一。
- General:
  - Font: 重要！ 设置编辑器中显示代码的字体、大小和行高。选择一个编程字体（如 JetBrains Mono, Fira Code, Cascadia Code 等）并调整合适的大小和行高可以极大地提升代码的可读性。
  - Code Completion: 配置代码自动完成的行为。
  - Code Folding: 配置代码折叠（隐藏代码块）的行为。
  - Scrolling: 配置滚动行为，例如是否显示代码迷你地图 (minimap)。
- Color Scheme: 配置代码语法高亮、背景颜色等的配色方案。您可以选择预设方案或自定义。
- Code Style: 重要！ 定义代码的格式化规则，例如缩进大小、空格使用、空行等。对于 Python，强烈建议遵循 PEP 8 规范。
  - 展开 Code Style，选择 Python。
  - 在 Tabs, Indents 选项卡中，确保 Tab size 和 Indent 都设置为 4，并确保 Use tab character 未勾选（Python 推荐使用空格缩进）。
  - 浏览其他选项卡，根据 PEP 8 或团队约定进行调整。PyCharm 的默认设置通常比较符合 PEP 8。
- Inspections: 配置 PyCharm 对代码进行的静态分析和检查。例如，语法错误、未使用的变量、不符合 PEP 8 的风格等。您可以启用或禁用特定的检查，并调整它们的严重程度。
- File Encodings: 确保项目和文件的编码设置正确（通常是 UTF-8）。
- Live Templates: 配置代码片段快捷方式（例如输入 main 然后按 Tab 键自动生成 if __name__ == "__main__": 代码块）。
Plugins (插件):
- 在这里，您可以浏览、安装、更新和管理 PyCharm 的插件。PyCharm 的强大之处很大一部分来自于其丰富的插件生态系统。
- Marketplace: 浏览和搜索 JetBrains 插件仓库中的插件。您可以搜索特定功能（如 Markdown 支持、YAML 支持、特定数据库工具、前端框架支持等）。点击插件名称，然后点击 “Install” 进行安装。
- Installed: 查看您已经安装的插件列表。您可以在这里禁用或卸载插件。
- 安装或禁用插件后，通常需要重启 PyCharm 才能生效。
Version Control (版本控制):
- 如果您使用 Git、Mercurial、Subversion 等版本控制系统，在这里可以进行配置。
- Git: 如果您的项目使用了 Git，在这里配置 Git 可执行文件的路径（PyCharm 通常会自动检测到）。您可以配置提交模板、忽略文件设置等。
Project: [您的项目名称] (项目设置):
- 在这个分类下（左侧导航栏底部），您可以找到针对当前项目特定的设置。
- Python Interpreter: 非常重要！ 您可以在这里查看和更改当前项目使用的 Python 解释器和虚拟环境。点击右侧的齿轮图标可以添加新的解释器或显示所有已配置的解释器。您还可以看到当前环境中已安装的库列表。点击列表下方的 + 按钮可以直接在 PyCharm 中搜索并安装新的库到当前虚拟环境中，非常方便。

配置完成后，点击 Settings 窗口底部的 “OK” 或 “Apply” 应用更改。

第六部分：安装 Python 包

PyCharm 的一个强大功能是方便地管理项目虚拟环境中的 Python 包。

通过 PyCharm UI 安装:
- 打开 PyCharm -> Settings... (或 Preferences...)。
- 在左侧导航栏找到 Project: [您的项目名称] -> Python Interpreter。
- 在右侧面板中，您会看到当前解释器路径和已安装的包列表。
- 点击包列表下方的 + 按钮。
- 会弹出一个“Available Packages”窗口。在搜索框中输入您想安装的包的名称（例如 requests, numpy, django）。
- 选择找到的包，您可以在右侧查看其描述和版本信息。您可以勾选 “Specify version” 来安装特定版本。
- 点击 “Install Package”。PyCharm 会在当前虚拟环境中运行相应的 pip install 命令。
- 安装完成后，包会出现在解释器设置页面的列表中。点击 “OK” 关闭设置窗口。
通过内置 Terminal 安装:
- 在 PyCharm 底部找到 Terminal 工具窗口（如果隐藏，点击底部边缘或 View -> Tool Windows -> Terminal）。
- 打开 Terminal 后，您会注意到命令行提示符通常会自动激活当前项目的虚拟环境（提示符前面会有 (venv) 或虚拟环境名称）。
- 使用 pip 命令安装包，例如：pip install 包名。
- 安装特定版本：pip install 包名==版本号。
- 安装项目依赖文件：pip install -r requirements.txt。
- 执行完命令后，PyCharm 通常会自动刷新 Python Interpreter 设置中的包列表。

推荐使用 PyCharm UI 来安装包，因为它提供了更直观的搜索和版本选择界面。但对于更复杂的安装或需要特定 pip 参数的情况，Terminal 仍然是必不可少的。

第七部分：一些有用的功能入门

安装和配置完成后，您可以开始使用 PyCharm 编写代码了。以下是一些您会经常用到的 PyCharm 功能：

代码编辑:
- 智能提示与自动完成: PyCharm 会根据上下文提供代码补全建议。
- 错误和警告高亮: PyCharm 会实时检查您的代码，用波浪线标记语法错误、未解决的引用或不符合 PEP 8 的风格问题。
- 快速修复: 将光标放在错误或警告上，按 Option + Enter (Alt + Enter) 可以看到 PyCharm 提供的快速修复建议。
- 代码导航: 按住 Command 键点击函数名、类名或变量名，可以直接跳转到其定义处。
- 重构: PyCharm 提供强大的重构功能，如变量重命名、方法提取、类移动等，可以安全地修改代码结构。
运行代码:
- 在编辑器中打开一个 Python 文件。
- 右键点击文件内部或在项目窗口中右键点击文件名。
- 选择 “Run ‘文件名’”。PyCharm 会在 Run 工具窗口中执行脚本并显示输出。
- 您也可以点击编辑区域右上角的绿色小三角形运行当前文件。
调试代码:
- 在您想暂停检查代码的地方，点击编辑器行号旁边的区域设置一个断点（一个红色圆点）。
- 右键点击文件或使用右上角的调试按钮（绿色瓢虫图标），选择 “Debug ‘文件名’”。
- 程序会在断点处暂停执行。Debug 工具窗口会自动打开，您可以在这里查看变量值、控制程序执行流程（单步跳过、单步进入、步出、继续执行）等。
版本控制集成 (Git):
- 如果在项目创建时或通过插件安装了 Git 支持，并在项目中初始化了 Git 仓库，PyCharm 会自动检测到。
- 底部会出现 Version Control 工具窗口，显示本地更改、提交历史等。
- 您可以通过 VCS 菜单执行 Git 操作，如 Commit (提交), Push (推送), Pull (拉取), Branch (分支) 管理等。
- PyCharm 在编辑器中也会用颜色标记代码行的修改状态。
Terminal:
- 底部工具窗口中的 Terminal 是一个完整的命令行终端，方便您执行各种命令行任务，如安装库、运行脚本、执行 Git 命令等。

第八部分：故障排除

在安装和配置过程中，您可能会遇到一些常见问题：

PyCharm 无法启动或崩溃: 确保您的 macOS 版本符合 PyCharm 的系统要求。尝试重启电脑。如果问题持续，可以尝试重新下载安装文件并重新安装。检查控制台日志 (Applications -> Utilities -> Console) 可能会提供线索。
找不到 Python 解释器:
- 确认您系统上已经安装了 Python，并且其路径是正确的。您可以在 Terminal 中输入 which python3 或 where python3 来查找 Python 3 解释器的路径。
- 在 PyCharm 的 Settings -> Project -> Python Interpreter 中，点击齿轮图标 -> Add Interpreter -> System Interpreter，看看 PyCharm 是否能检测到已安装的 Python。如果不能，可能需要手动指定路径。
虚拟环境创建失败: 检查您的磁盘空间是否充足。确保您选择的“Base interpreter”是有效的 Python 解释器。尝试在 Terminal 中手动使用 python3 -m venv venv_name 命令创建虚拟环境，看是否能成功。
安装包失败: 确保您的虚拟环境已激活。检查网络连接。有时可能是 pip 源的问题，您可以尝试更换 pip 源（虽然这通常在 Terminal 中配置）。查看 Run 或 Terminal 工具窗口中 pip install 命令的详细输出，通常会说明失败原因。
性能问题 (PyCharm 运行缓慢): 关闭不需要的项目。检查是否有占用大量资源的后台进程。在 PyCharm 的 Help 菜单下，有一些诊断工具，例如 Activity Monitor 可以查看 IDE 的资源占用。有时增加 IDE 的内存分配（通过修改启动参数，这是比较高级的配置）可以改善性能，但这需要谨慎操作。

结论

恭喜您！通过遵循本指南，您应该已经在 Mac 上成功安装并初步配置了 PyCharm。我们从下载、安装、首次启动到创建项目、配置 Python 解释器（特别是虚拟环境），以及基本的界面概览和常用设置进行了详细说明。

PyCharm 是一款功能极其丰富的 IDE，本文只是冰山一角。花时间探索其菜单、工具窗口和设置，熟悉常用的快捷键，将极大地提升您的 Python 开发体验。从现在开始，您可以利用 PyCharm 强大的代码辅助、调试能力和集成工具，更高效地编写、运行和维护您的 Python 项目。

记住，为每个项目使用独立的虚拟环境是良好的实践，它可以让您的开发环境保持整洁和可控。随着您项目的复杂性增加，您会越来越体会到虚拟环境的重要性。

祝您在 PyCharm 和 Python 的世界里探索愉快！