第一个项目

8.1 IDE 结构解析

好了，我们创建了一个新项目。来看看这里都有什么吧。

1. 项目的文件和文件夹结构：

这里显示的是我们项目文件夹的内容 — pythonProject。

2. 当前打开的文件：

这是 — 文件 main.py 的内容，代码语法会高亮显示。

3. 上面的主菜单：

右上角的有用按钮：

• 「绿色三角形」— 启动项目的按钮。
• 「小虫子」— 启动调试模式的按钮。
• 「放大镜」— 项目搜索。
• 「齿轮」— 设置。

4. 左侧的侧边菜单：

这里有几个有用的按钮，其中我们尤其关心 Terminal 按钮。

5. 状态栏：

状态栏左侧显示的是当前打开文件的路径。右侧显示的是它的编码：CRLF, UTF-8。

在完全右侧显示的是当前运行我们项目的 Python 版本 — Python 3.12.x。这可能会派上用场，如果你的计算机上安装了多个不同版本的 Python，并且有些项目在其他版本上运行。

8.2 项目解析

一个普通的项目由显示在左侧面板中的文件组成。这些文件可以大致分为 4 个部分。

Python 代码文件。此类文件具有 .py 扩展名，PyCharm 会用蓝黄色图标标记它们。目前我们的项目中只有一个这样的文件 — main.py

静态文件。 這是指包含数据但不包含代码的文件。这可以是文本文件、图像、媒体文件等等。目前我们的项目中没有这些文件。

Python 虚拟环境。在名为 .venv（Virtual Environment 的缩写）的文件夹中包含 Python 文件以及一些服务实用程序。包管理器 pip 也会将您想要使用的第三方库下载到这里。

第三方库 (External libraries)。目前我们的项目中没有这些，但当您下载它们时，PyCharm 一定会在这里显示它们。

8.3 虚拟环境 .venv

让我们稍微详细地谈谈虚拟环境。.venv 是 Python 中的一个模块，提供了为 Python 项目创建各种轻量级和隔离虚拟环境的能力。这是一个允许管理项目依赖项并将其与系统库隔离的工具。想象一下，这是您项目的一个隔离房间，它可以在这里存放自己的私人玩具和工具，而不打扰家里的其他住户。

从技术上讲，它的工作原理很简单：在项目文件夹内创建 Python 解释器的副本和一个单独的库及其存放处。这保证了如果您为一个项目安装了某​​个特定版本的库，它不会破坏另一个需要较旧版本的项目。使用虚拟环境是一种良好的习惯，可以避免无休止的版本冲突。

在 PyCharm 中管理环境

PyCharm 通常会自行处理并自动创建所有内容。但有时您可能会意外删除了所需的文件夹，或者只是想从头开始。能够手动管理这些设置是一项有用的技能。

创建环境

在右下角显示 Python 连接状态。如果您在那里看到类似 Python 3.XX 的字样，表示安装成功。开发环境看到了解释器并准备好执行您的命令。

如果那里写着 No interpreter，请点击该字样。

1. 在出现的菜单中选择 Add New Interpreter，然后选择 Add Local Interpreter。
2. 在左侧的设置中选择 Environment。在中间确保勾选了 Generate New。
3. 点击 OK。编辑器将创建一个新的 .venv 文件夹并立即将项目切换到该文件夹。现在您拥有一个绝对干净的系统，没有多余的垃圾。

删除旧的或多余的

有时实验会走进死胡同，删除环境比尝试修复它更容易。以下是如何做到这一点：

1. 再次点击右下角的 Python 版本并选择 Interpreter Settings 项目。
2. 在顶部寻找 Python Interpreter 字段。展开列表并选择 Show All 项目。
3. 您将看到 PyCharm 知道的所有环境的列表。选择您想要删除的环境，然后点击列表上方菜单中的 减号 按钮。
4. 重要的一点：PyCharm 只是“忘记”了这个环境并停止使用它。要物理释放磁盘空间，您需要通过一般的文件资源管理器进入项目文件夹并手动删除 .venv 文件夹。

创建第二个环境

错误：“Already contains Python”

如果您进入添加解释器菜单并选择 Generate new，PyCharm 可能会显示红色警告并锁定 OK 按钮。发生这种情况是因为编辑器习惯性地尝试在同一个 .venv 文件夹中创建新环境，而该文件夹已经被您的第一个环境占用。两个不同的库集合不能共存在一个文件夹中。

如何修复此问题

只需给新的“沙盒”一个唯一的名称即可。以下是如何做到这一点：

1. 打开 Add Local Interpreter 菜单，就像我们之前做的那样。
2. 选择 Generate new 项目。
3. 查看 Location 字段。最有可能的是，那里的路径以标准名称 \.venv 结尾。
4. 将光标放在行尾，只需在那里添加任何数字即可。将路径结尾更改为 \.venv_2 并按 Enter。
5. 红色字样将立即消失。点击 OK。

现在您的项目中将物理存在两个不同的设置文件夹，PyCharm 会自动切换到新版本。

如何在环境之间切换

在环境之间切换的能力是一项重要技能。但这里有一个陷阱：PyCharm 并不总是自动记住您的旧环境。

经常发生这样的情况：您创建了一个新环境，而第一个环境从菜单中消失了，尽管 .venv 文件夹仍在项目中。在这种情况下，您只需告诉 PyCharm 在哪里寻找旧的 Python。从 .venv_2 切换到 .venv 的示例：

1. 点击角落的 Python 版本并选择 Add New Interpreter -> Add Local Interpreter。
2. 在出现的窗口中，将点切换到 Select Existing 项目。
3. 在 Python Path 字段中，点击右侧的文件夹图标。
4. 现在您需要在旧文件夹 (.venv) 中找到 Python 启动文件。路径为：您的项目 -> .venv -> Scripts（Windows）或 bin（macOS/Linux）。
5. 在此文件夹内选择 python 文件并点击 OK。

现在旧环境将再次出现在设置中并变为活动状态。即使 PyCharm“忘记”了您的设置，此方法也绝对有效。

8.4 使用终端

在 PyCharm 中你可以直接使用操作系统的命令行。在 Linux 和 MacOS 中，命令行通常称为终端 (Terminal)，所以在 PyCharm 里也这么叫。其实这并不是 PyCharm 的特例，而是程序员中普遍接受的命名。

要打开 Terminal，你需要点击侧边菜单中的终端按钮：

你应该会看到这样的窗口：

在这个窗口里，你可以输入操作系统的命令。我们感兴趣的是其中之一。

让我们看看我们安装的 Python 解释器的当前版本。为此，需要输入：

        python --version

这是我的输出：

如果你也输出了 Python 3.12.x，那就说明我们走在正确的路上。