Windows和Mac怎么安装Python并配置开发环境

闻溪
闻溪
发布时间:2026-10-24 | 5人浏览过
原创

在不同操作系统上搭建 Python 开发环境的核心任务只有三件事:正确获取并安装 Python 官方解释器、确保系统终端能够正确识别命令行调用路径(PATH 环境变量),以及配置一个具备虚拟环境隔离与代码调试能力的编辑器。本文分别针对 Windows 和 macOS 两个主流平台,从官方安装包获取、关键配置项选择、命令行可用性验证,一直讲到基于 VS Code 的轻量现代化工程环境搭建,帮助读者快速获得一个干净、可靠且互不干扰的 Python 开发工作流。

Windows和Mac怎么安装Python并配置开发环境
图 1:Python 运行环境与工程化开发配置的四个标准阶段

一、Windows 平台安装 Python 与环境变量配置

在 Windows 环境下,最常见的问题是安装完成后在命令行输入 python 却提示“不是内部或外部命令”。这几乎全部是因为安装时未将 Python 执行文件目录注入系统 PATH 环境变量所致。因此,严格按照以下步骤进行操作能避免绝大多数入门卡点。

1. 下载官方安装程序

打开浏览器访问 Python 官方网站下载页面(python.org/downloads/windows)。页面通常会突出显示当前最新的稳定版本(如 Python 3.12 或 3.13)。请点击下载 Windows installer (64-bit),该文件通常命名为 python-3.x.x-amd64.exe。

2. 执行安装与关键选项设置

双击运行下载好的 .exe 安装程序,界面底部会出现两个非常关键的复选框:

  • Use admin privileges when installing py.exe:保持默认勾选即可。
  • Add python.exe to PATH:务必手动勾选该项! 勾选后,安装程序会自动将 Python 运行目录及 Scripts 目录写入当前用户的 PATH 变量中,免去后续手动修改注册表或系统属性的繁琐操作。

选择“Customize installation”(自定义安装),检查 Documentation、pip、tcl/tk and IDLE、Python test suite 保持勾选,点击 Next。在高级选项(Advanced Options)中,建议勾选“Install Python for all users”(为所有用户安装),并将安装路径修改为简洁的自定义路径(例如 C:\Python312),避免深层目录、带空格的用户名路径导致部分底层 C 扩展构建脚本解析失败。

3. 终端验证

安装完成后,使用快捷键 Win + R 打开运行窗口,输入 powershell 或 cmd 回车,执行以下命令:

python --version
pip --version

如果控制台正确输出类似 Python 3.12.3 以及 pip 的安装路径信息,说明解释器与包管理工具已成功就绪。

排错提醒: 如果依然提示找不到命令,请关闭当前命令行窗口重新打开(环境变量更新对已打开的终端不生效)。若仍未识别,请在 Windows 搜索框搜索“环境变量”,在“系统变量”下的 Path 中新增两行:C:\Python312\ 和 C:\Python312\Scripts\。

二、macOS 平台安装 Python 与终端调优

macOS 系统在不同架构(Intel 芯片与 Apple Silicon 芯片)以及不同系统版本上对 Python 的管理策略各有不同。早期 macOS 自带 Python 2.7,而现代 macOS(macOS 12.3 以后)已完全移除了内置的 Python 2,仅保留供 Xcode Command Line Tools 调用的基础存根。因此,我们必须为日常开发安装独立的 Python 3。

Windows和Mac怎么安装Python并配置开发环境
图 2:Windows 与 macOS 在安装路径、命名方式及环境变量机制上的核心差异

1. 方式 A:官网 PKG 安装包(推荐初学者)

访问 python.org/downloads/macos,下载 macOS 64-bit universal2 installer。双击打开 .pkg 文件后,按照向导一路点击“继续”即可完成安装。安装程序会自动将 /Library/Frameworks/Python.framework/Versions/3.x/bin 加入系统的 shell 初始化路径中。

2. 方式 B:使用 Homebrew 安装(适合有终端习惯的用户)

若系统中已安装 Homebrew,可以在终端中直接输入一行命令完成部署:

brew install python

Homebrew 会自动处理 OpenSSL 等基础编译依赖,并将可执行文件链接至 /opt/homebrew/bin(Apple Silicon 芯片)或 /usr/local/bin(Intel 芯片)。

3. 终端验证与命令区分

在 Mac 上打开“终端”(Terminal),请注意:现代系统必须明确调用 python3 和 pip3,直接输入 python 可能会提示未安装或提示指向过时的存根程序。

python3 --version
pip3 --version

如果希望在终端中输入 python 也能直接指向 Python 3,可以在 ~/.zshrc 中加入别名:

echo "alias python=python3" >> ~/.zshrc
source ~/.zshrc

三、现代 Python 开发环境配置:VS Code 与虚拟环境实践

很多初学者在安装好 Python 后直接用自带的 IDLE 或者全局环境安装第三方包,时间一长就会遇到包版本冲突(例如项目 A 需要 Pandas 1.x,项目 B 需要 Pandas 2.x)。现代工业界推荐的做法是:全局仅保留一个纯净的 Python 基础解释器,每个独立项目都通过 venv 创建专属虚拟环境,并使用 VS Code 作为开发与调试中心。

Windows和Mac怎么安装Python并配置开发环境
图 3:现代 Python 开发推荐采用的项目级虚拟环境隔离模式

1. 安装 VS Code 与 Python 扩展

  1. 前往官网 code.visualstudio.com 下载并安装 Visual Studio Code。
  2. 启动 VS Code,点击左侧活动栏的“扩展”(Extensions)图标(快捷键 Ctrl+Shift+X / Cmd+Shift+X)。
  3. 在搜索栏输入 Python,认准由 Microsoft 官方发布的插件,点击 Install。此插件集成了代码补全(Pylance)、语法检查、单步断点调试及测试套件运行功能。

2. 实战创建并激活虚拟环境

在电脑上新建一个存放代码的空文件夹(例如 my_project),使用 VS Code 打开该文件夹(File -> Open Folder)。按下快捷键 Ctrl+` 打开 VS Code 内置终端,执行创建命令:

Windows 系统操作命令:

# 创建虚拟环境目录 .venv
python -m venv .venv

# 激活虚拟环境 (PowerShell)
.venv\Scripts\Activate.ps1

macOS 系统操作命令:

# 创建虚拟环境目录 .venv
python3 -m venv .venv

# 激活虚拟环境 (zsh/bash)
source .venv/bin/activate

当终端命令行提示符最前面出现 (.venv) 前缀时,表示当前会话已成功切换至虚拟环境。此时运行 pip install 安装的任何第三方库都会存放在当前项目目录的 .venv 下,绝不污染系统全局。

3. 在 VS Code 中关联虚拟环境解释器

创建虚拟环境后,VS Code 通常会在右下角自动弹出提示询问是否将其作为工作区解释器。如果未弹出,可通过以下方式手动指定:

  • 按快捷键 Ctrl+Shift+P(Mac 为 Cmd+Shift+P)打开命令面板。
  • 输入 Python: Select Interpreter 并回车。
  • 在列表中选择带有 ('.venv': venv) 标记的解释器路径。

4. 运行与验证第一个脚本

在当前工程根目录下新建 main.py 文件,写入测试代码:

import sys

def main():
    print("Python 环境配置成功!")
    print(f"当前运行解释器位置: {sys.executable}")

if __name__ == "__main__":
    main()

点击编辑器右上角的三角形“Run Python File”按钮,下方终端将输出带有 .venv 路径的信息,说明开发环境配置彻底闭环。

四、网络加速与开发环境自查清单

在国内网络环境下,使用默认官方源安装第三方库经常出现连接超时(ReadTimeoutError)。建议为 pip 配置国内镜像源,显著提升下载效率。

# 为当前用户全局设置清华大学镜像源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

完成所有操作后,请对照下方的自查清单逐项核验您的开发环境:

Windows和Mac怎么安装Python并配置开发环境
图 4:Python 开发环境四个维度的验收标准与自查清单

五、总结

搭建 Python 开发环境并不是单纯地点开安装包“下一步”,其核心在于理顺操作系统路径机制并建立规范的工程隔离习惯。Windows 重点关注安装时的“Add python.exe to PATH”勾选;macOS 则需注意遵循现代规范并使用 python3。在此基础上,通过 VS Code 搭配 venv 虚拟环境,能够彻底摆脱环境冲突,确保后续无论是进行数据分析、脚本编写还是 Web 开发,都能拥有稳定、可控且清晰的编程体验。

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表