下面我将详细解释如何在 PyCharm 中配置和使用 Python 版本,涵盖从新手到高级用户的各种情况。

核心概念:项目解释器
理解这个概念是关键,在 PyCharm 中,每个项目都应该关联一个“项目解释器”(Project Interpreter),这个解释器就是用来运行你项目代码的 Python 引擎。
- 为什么每个项目都要有?
- 项目隔离:你的项目 A 可能需要 Python 3.8 和某个旧版本的库,而项目 B 可能需要 Python 3.11 和最新的库,为每个项目设置独立的解释器可以避免版本冲突。
- 依赖管理:PyCharm 会根据你选择的解释器来安装和管理项目所需的库(包)。
如何在 PyCharm 中设置 Python 版本
主要有两种方式:
- 使用已安装的 Python 版本(最常见)
- 在 PyCharm 内部创建一个新的虚拟环境(推荐的最佳实践)
使用已安装的 Python 版本
如果你的电脑上已经通过官网安装器、Anaconda 或其他方式安装了 Python,可以直接让 PyCharm 使用它。
步骤:

- 打开你的项目。
- 进入
File->Settings(Windows/Linux) 或PyCharm->Settings(macOS)。 - 在设置窗口中,导航到
Project: <你的项目名>->Python Interpreter。 - 在右侧,你会看到一个下拉菜单,显示当前项目使用的解释器。
- 点击齿轮图标 ⚙️,然后选择
Add Interpreter...。 - 在弹出的窗口中,选择左侧的
System Interpreter。 - 在右侧的
Interpreter路径下拉菜单中,PyCharm 会自动扫描并列出你系统中所有找到的 Python 可执行文件(如python.exe,python3.exe),如果没有自动列出,你可以点击 按钮手动浏览到你的 Python 安装目录下的python.exe(Windows) 或python(macOS/Linux) 文件。- Windows 路径示例:
C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\python.exe - macOS/Linux 路径示例:
/usr/bin/python3或/usr/local/bin/python3
- Windows 路径示例:
- 选择你想要的 Python 版本,点击
OK。 - 返回设置窗口,点击
Apply和OK,PyCharm 会重新索引你的项目。
在 PyCharm 中创建虚拟环境(强烈推荐)
这是最专业、最推荐的做法,虚拟环境会为你的项目创建一个隔离的 Python 环境,拥有独立的库和依赖,不会影响你系统全局的 Python 环境。
步骤:
- 打开你的项目。
- 进入
File->Settings->Project: <你的项目名>->Python Interpreter。 - 在右侧,点击齿轮图标 ⚙️,然后选择
Add Interpreter...。 - 在弹出的窗口中,选择左侧的
Virtualenv。 - 配置虚拟环境:
- New environment:选择此项。
- Base interpreter:这里选择你希望作为基础的 Python 版本,如果你想创建一个 Python 3.10 的虚拟环境,就从下拉菜单中选择
python3.10的路径,这个基础版本必须是已经安装在你系统上的。 - Location:虚拟环境文件夹将被创建的位置,PyCharm 默认会放在项目根目录下的
.venv文件夹中,这是一个很好的约定。 - Inherit global site-packages:强烈建议保持默认的未勾选状态,这可以确保你的项目是完全隔离的。
- 点击
OK。 - PyCharm 会自动创建虚拟环境,并将其设置为你的项目解释器,创建完成后,你就可以在右下角的
Terminal(终端) 中看到命令提示符已经变成了虚拟环境的路径((.venv) C:\...\my_project>)。
如何检查当前项目使用的 Python 版本?
有几种简单的方法:
-
通过设置界面:
(图片来源网络,侵删)File->Settings->Project: <你的项目名>->Python Interpreter。- 右侧会清晰显示当前解释器的路径和版本号。
-
通过代码:
- 在任何一个
.py文件中输入以下代码并运行:import sys print(sys.version)
- 输出结果会显示详细的 Python 版本信息。
- 在任何一个
-
通过终端:
- 打开 PyCharm 底部的
Terminal(终端)。 - 输入命令
python --version或python -V。 - 如果你设置了虚拟环境,终端会默认使用虚拟环境中的 Python,显示的就是项目版本。
- 打开 PyCharm 底部的
常见问题与最佳实践
如何为多个项目使用不同的 Python 版本?
很简单,只需要为每个项目单独配置其 Project Interpreter即可,项目 A 配置 Python 3.8,项目 B 配置 Python 3.11,互不干扰。
我应该使用系统解释器还是虚拟环境?
| 特性 | 系统解释器 | 虚拟环境 |
|---|---|---|
| 隔离性 | 差,所有项目共享全局库,容易产生冲突。 | 好,每个项目环境独立,库版本互不影响。 |
| 依赖管理 | 困难,升级/卸载库会影响所有项目。 | 简单,每个项目可以拥有自己独立的依赖列表。 |
| 项目可移植性 | 差,依赖于他人电脑上是否安装了相同的库和版本。 | 好,可以将 requirements.txt 文件分享给他人,轻松复现环境。 |
| 推荐场景 | - 快速学习、写简单脚本。 - 使用 Conda 等强大的环境管理工具时。 |
- 几乎所有 Python 项目,尤其是需要用到第三方库的项目。 - 团队协作项目。 - Web 开发、数据分析等。 |
除非有特殊原因,始终为你的项目创建一个虚拟环境,这是专业 Python 开发的标准做法。
如何在虚拟环境中安装库?
创建好虚拟环境后,安装库非常方便:
-
在 PyCharm 界面中安装:
File->Settings->Project: <你的项目名>->Python Interpreter。- 在右侧的包列表下方,点击 号。
- 在弹出的窗口中搜索你想要的库(如
requests,numpy),然后点击Install Package。
-
在终端中安装:
- 打开 PyCharm 的
Terminal。 - 直接使用
pip命令,因为终端已经激活了虚拟环境,pip会自动作用于当前环境。pip install requests
- 打开 PyCharm 的
希望这份详细的指南能帮助你完全掌握在 PyCharm 中管理 Python 版本的方法!
