Python配置教程:Windows、macOS、Linux安装、运行与pip环境设置
简答:Python配置的完整顺序是:安装解释器、验证命令、创建项目目录、运行第一个.py文件、创建虚拟环境、再用pip安装依赖。Windows优先检查python或py命令,macOS和Linux通常检查python3;如果pip下载失败,再单独排查网络、代理、权限和包源问题。
定义:Python配置是指安装Python解释器、让终端能够找到它,并为项目准备编辑器、pip和隔离的虚拟环境。
先完成这6步:Python安装与首次运行速查
本文按新手最容易卡住的顺序编排。安装包、命令名称和可用版本会随系统与官方页面变化,下载时应以Python官网当前下载页面为准。本文核验时间为2026-11-04。
| 步骤 | Windows | macOS | Linux | 完成标准 |
|---|---|---|---|---|
| 安装解释器 | 官网下载或使用Microsoft Store、winget | 使用官网说明或Homebrew | 优先使用发行版包管理器 | 安装过程无报错 |
| 验证版本 | py --version 或 python --version | python3 --version | python3 --version | 显示Python 3.x |
| 验证pip | py -m pip --version | python3 -m pip --version | python3 -m pip --version | 显示pip路径和对应Python |
| 运行脚本 | py hello.py | python3 hello.py | python3 hello.py | 终端输出Hello, Python! |
| 创建环境 | py -m venv .venv | python3 -m venv .venv | python3 -m venv .venv | 项目目录出现.venv文件夹 |
先试这一步:打开终端,按照系统运行版本检查命令。若命令找不到,不要立刻重复安装,先看本文后面的“命令找不到”排查表。
安装Python:按系统选择路径
Windows 10或Windows 11
- 打开Python官网的下载页面,选择当前页面提供的稳定版本;不要根据旧教程写死补丁版本。
- 运行安装程序时,留意安装界面是否提供将Python加入PATH的选项。若勾选项存在,按当前安装器页面提示操作;如果没有看到该选项,安装完成后用
py启动器验证。 - 也可以按照Microsoft Learn的Windows Python环境说明,使用WinGet或Microsoft Store安装。WinGet命令、商店页面和可用版本以当前页面为准。
- 关闭并重新打开PowerShell或Windows Terminal,再运行
py --version。如果系统没有py,再尝试python --version。
结果判断:能显示Python 3.x版本,说明解释器已被找到;若出现“不是内部或外部命令”,优先重新打开终端并检查PATH。恢复方法是使用安装器的修改或修复入口,或重新安装时按当前页面重新确认PATH设置。
macOS
- 不要把系统自带的Python当作项目环境。VS Code官方教程明确建议使用独立的Python安装方式;可按当前官方说明选择Python官网安装包或Homebrew。
- 如果使用Homebrew,终端命令为
brew install python3,前提是电脑已经安装并能运行Homebrew。 - 安装后重新打开Terminal,运行
python3 --version和python3 -m pip --version。
结果判断:两个命令都能返回版本或路径即可继续。若python3存在但pip不可用,不要直接修改系统目录,先按Python Packaging User Guide的说明检查pip或在项目虚拟环境中操作。
Linux
- Linux发行版通常已经提供Python 3,但不同发行版的包管理命令和软件包名称可能不同。
- 优先使用当前发行版的包管理器安装Python和pip;安装后运行
python3 --version。 - 如果pip缺失,先查看发行版文档或Python Packaging User Guide关于Linux包管理器的说明,不建议在系统Python上直接执行未经核验的安装脚本。
结果判断:系统能运行Python 3,并且项目环境可以创建venv。如果系统提示外部管理环境或权限不足,优先创建虚拟环境,而不是强行修改系统目录。
验证Python、pip并运行第一个程序
Python解释器、终端、编辑器和pip不是同一个东西:解释器负责运行代码,终端负责执行命令,编辑器负责编写文件,pip负责安装Python包。VS Code的Python扩展只提供编辑、运行和调试支持,并不包含Python解释器本身,具体关系可参考VS Code官方Python教程。
- 新建一个项目目录,例如
hello-python,然后进入该目录。 - 新建文件
hello.py,写入以下内容:print("Hello, Python!")。 - 在项目目录打开终端。Windows运行
py hello.py;macOS或Linux运行python3 hello.py。 - 如果终端输出
Hello, Python!,说明解释器、文件路径和基本运行流程均正常。
也可以安装VS Code和Python扩展。打开项目文件夹后,使用命令面板中的“Python: Select Interpreter”选择已安装的解释器,再点击编辑器右上角的运行按钮。若运行结果使用了错误版本,先重新选择解释器,再检查终端中的版本命令。
用venv创建项目独立环境,再安装依赖
虚拟环境用于把某个项目的依赖与系统Python、其他项目隔离。Python Packaging User Guide说明,venv可创建项目专用环境,能减少不同项目之间的包版本冲突。
- 在项目目录创建环境。Windows运行
py -m venv .venv;macOS或Linux运行python3 -m venv .venv。 - 激活环境。Windows命令提示符运行
.venv\Scripts\activate;macOS或Linux运行source .venv/bin/activate。PowerShell的激活命令可能受执行策略影响,以当前系统提示为准。 - 激活后再次运行版本检查命令。若终端提示符出现环境名称,或
python -m pip --version显示路径位于项目的.venv目录,说明环境已生效。 - 安装依赖时使用当前解释器调用pip:Windows运行
python -m pip install 包名或py -m pip install 包名;macOS/Linux运行python3 -m pip install 包名。 - 完成后运行
deactivate退出环境。删除项目环境时,关闭终端后删除项目下的.venv文件夹即可,源代码不会因此被删除。
如果出现权限错误,优先确认是否已经激活虚拟环境。Microsoft的Windows说明也建议,无法写入全局安装目录时优先使用虚拟环境。若安装包下载超时或连接失败,先检查当前网络、代理设置、DNS解析和包索引可达性;不要把网络错误直接判断为Python安装失败。
常见报错:现象、判断、操作与回退
| 现象 | 优先判断 | 操作 | 验证与回退 |
|---|---|---|---|
| python或python3找不到 | PATH未刷新、命令名称不同或解释器未安装 | 重新打开终端,Windows尝试py --version,macOS/Linux尝试python3 --version | 能返回版本即可;仍失败时检查安装器或重新安装,先保留项目文件 |
| pip找不到 | pip未安装、调用了另一套Python | 使用python -m pip --version、python3 -m pip --version或py -m pip --version | 路径应对应当前解释器;不要混用多个Python的pip |
| pip权限不足 | 正在写入系统级目录 | 激活.venv后重新安装;确认命令行路径已切换 | 包安装到项目环境;若要回退,退出环境并删除该环境 |
| 安装包连接超时 | 网络、代理、DNS或包索引访问异常 | 先用浏览器检查包索引页面,再查看当前终端代理变量和企业网络策略 | 能重新获取包元数据再继续;不要反复升级Python来解决网络问题 |
| VS Code运行版本不对 | 编辑器选中了另一套解释器 | 命令面板执行“Python: Select Interpreter”,选择项目中的.venv | 在VS Code终端运行版本和pip路径;若仍不对,关闭并重新打开工作区 |
Python配置完成后的自查清单
- 已从可核验的Python官方页面获取安装入口,并以当前页面版本为准。
- 能在当前系统终端返回Python 3.x版本。
- 能用与解释器匹配的方式检查pip,而不是只运行一个可能指向其他环境的
pip命令。 - 能创建并运行
hello.py。 - 项目已经创建
.venv,并能激活、退出和重新激活。 - VS Code选择的是项目解释器,而不是系统中另一套Python。
- 如果安装依赖失败,已区分权限问题、版本冲突和网络连接问题。
如果你的主要问题是安装包、编辑器或依赖下载时连接不稳定,可先完成上述本地验证,再按连接问题排查和VPN显示已连接但无法上网的排查步骤区分设备、网络和应用层问题。
常见问题
Python应该安装哪个版本?
不要照抄旧教程中的补丁版本。打开Python官网当前下载页,优先选择仍处于支持周期、且与你需要使用的第三方库兼容的版本。若项目已有明确版本要求,应以项目文档为准。
Windows中python和py有什么区别?
两者都可能用于启动Python,但是否可用取决于安装方式和PATH配置。Windows可以先运行py --version,再尝试python --version;后续安装包时使用与实际解释器匹配的py -m pip或python -m pip。
macOS为什么建议使用python3?
macOS上的命令名称和安装来源可能不同,当前VS Code教程使用python3作为示例。安装完成后,以python3 --version和python3 -m pip --version验证,不要假设python一定指向你刚安装的解释器。
pip install失败是不是Python没有安装好?
不一定。常见原因包括网络或代理连接、权限不足、项目依赖不兼容、缺少编译工具以及使用了错误的解释器。先运行与当前解释器匹配的pip版本检查,再确认是否已激活.venv,最后查看具体错误行。
必须安装VS Code才能使用Python吗?
不必须。Python解释器可以直接通过终端运行.py文件,VS Code只是编辑、运行和调试工具。初学者可以先用终端完成版本验证和Hello World,再根据需要安装VS Code及Python扩展。