macOS使用Homebrew+VS Code搭建Python开发环境完整指南

本文详细介绍了在 macOS 环境下，如何通过 Homebrew 安装 Python 3，并结合 Visual Studio Code（VS Code）完成基础开发环境的配置。内容涵盖 Homebrew 安装与验证、Python 安装与版本确认、VS Code 中文界面设置、Python 官方扩展配置、解释器选择以及第一个 Python 项目的创建与依赖管理。适合 Python 初学者以及需要快速搭建标准开发环境的开发者参考。

通过 Homebrew 安装 Python

1. 安装 Homebrew（如已安装可跳过）

在终端中执行以下命令：

/bin/bash -c"$(curl-fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，可通过以下方式确认 Homebrew 是否已成功安装：

brew -v

2. 使用 Homebrew 安装 Python3

执行命令：

brewinstallpython

安装过程示例：

3. 验证 Python 与 pip 是否安装成功

在终端中执行：

python3 --version pip3 --version

正常情况下会输出类似信息：

Python 3.12.x pip 23.x

验证示例：

安装 Visual Studio Code

前往 VS Code 官网下载安装：

将 VS Code 界面切换为中文

1. 打开扩展市场

在 VS Code 中：

• 点击左侧Extensions（扩展）
• 搜索关键词：Chinese

2. 安装官方中文语言包

选择并安装以下扩展：

• Chinese (Simplified) Language Pack for Visual Studio Code
• 发布者：Microsoft（官方）

3. 应用语言设置

安装完成后，VS Code 会提示重启：

• 点击Restart
• 重启后界面即切换为简体中文

配置 Python 开发环境

1. 安装 Python 官方扩展

在 VS Code 左侧扩展中搜索并安装：

• Python（Microsoft）

该扩展提供以下能力：

• Python 解释器管理
• 代码补全与语法检查
• 调试支持
• 虚拟环境识别

2. 选择 Python 解释器

在 VS Code 中进行如下操作：

1. 按下Cmd + Shift + P
2. 输入并选择：Python: Select Interpreter
3. 选择Homebrew 安装的 Python 3（避免选择/usr/bin/python）

如图所示：

创建第一个 Python 项目

1. 新建项目目录

在本地新建一个用于存放 Python 项目的目录，并通过 VS Code 打开：

2. 创建并运行第一个 Python 文件

新建文件 T.py，并输入以下代码：

print("Hello, Python")

运行方式可任选其一：

方式 A：终端运行

python3 T.py

方式 B：VS Code 运行按钮

• 点击右上角Run Python File

运行示例：

安装基础第三方依赖包

以requests库为例：

pipinstallrequests

验证是否安装成功：

importrequestsprint(requests.__version__)

若能正常输出版本号，则说明依赖安装成功。

创建并使用 Python 虚拟环境（venv）

在实际开发中，强烈建议为每个项目创建独立的虚拟环境，以避免不同项目之间的依赖版本冲突，同时提升环境的可维护性与可复现性。

1. 在项目目录中创建虚拟环境

确保当前终端路径位于你的项目根目录下，然后执行：

python3 -m venv venv

执行完成后，项目目录结构通常如下：

project/ ├── venv/ ├── T.py

其中：

• venv/：当前项目专用的 Python 虚拟环境
• T.py：项目代码文件

2. 激活虚拟环境（macOS / Linux）

在项目目录中执行：

sourcevenv/bin/activate

激活成功后，终端提示符前通常会出现(venv)，例如：

(venv) user@mac project %

这表示当前终端会话已切换到该虚拟环境。

3. 在虚拟环境中安装依赖

虚拟环境激活后，使用pip安装的所有依赖仅对当前项目生效：

pipinstallrequests

验证安装位置是否正确：

whichpythonwhichpip

输出路径应位于：

.../project/venv/bin/python .../project/venv/bin/pip

4. 退出虚拟环境

当项目开发结束或需要切换环境时，可执行：

deactivate

终端提示符恢复正常，表示已退出虚拟环境。