EK13-VPN

Python配置教程:Windows、macOS、Linux安装、运行与pip环境设置

更新于 2026-11-04 · ek13.site

简答:Python配置的完整顺序是:安装解释器、验证命令、创建项目目录、运行第一个.py文件、创建虚拟环境、再用pip安装依赖。Windows优先检查python或py命令,macOS和Linux通常检查python3;如果pip下载失败,再单独排查网络、代理、权限和包源问题。

定义:Python配置是指安装Python解释器、让终端能够找到它,并为项目准备编辑器、pip和隔离的虚拟环境。

先完成这6步:Python安装与首次运行速查

本文按新手最容易卡住的顺序编排。安装包、命令名称和可用版本会随系统与官方页面变化,下载时应以Python官网当前下载页面为准。本文核验时间为2026-11-04。

步骤WindowsmacOSLinux完成标准
安装解释器官网下载或使用Microsoft Store、winget使用官网说明或Homebrew优先使用发行版包管理器安装过程无报错
验证版本py --version 或 python --versionpython3 --versionpython3 --version显示Python 3.x
验证pippy -m pip --versionpython3 -m pip --versionpython3 -m pip --version显示pip路径和对应Python
运行脚本py hello.pypython3 hello.pypython3 hello.py终端输出Hello, Python!
创建环境py -m venv .venvpython3 -m venv .venvpython3 -m venv .venv项目目录出现.venv文件夹

先试这一步:打开终端,按照系统运行版本检查命令。若命令找不到,不要立刻重复安装,先看本文后面的“命令找不到”排查表。

安装Python:按系统选择路径

Windows 10或Windows 11

  1. 打开Python官网的下载页面,选择当前页面提供的稳定版本;不要根据旧教程写死补丁版本。
  2. 运行安装程序时,留意安装界面是否提供将Python加入PATH的选项。若勾选项存在,按当前安装器页面提示操作;如果没有看到该选项,安装完成后用py启动器验证。
  3. 也可以按照Microsoft Learn的Windows Python环境说明,使用WinGet或Microsoft Store安装。WinGet命令、商店页面和可用版本以当前页面为准。
  4. 关闭并重新打开PowerShell或Windows Terminal,再运行py --version。如果系统没有py,再尝试python --version。

结果判断:能显示Python 3.x版本,说明解释器已被找到;若出现“不是内部或外部命令”,优先重新打开终端并检查PATH。恢复方法是使用安装器的修改或修复入口,或重新安装时按当前页面重新确认PATH设置。

macOS

  1. 不要把系统自带的Python当作项目环境。VS Code官方教程明确建议使用独立的Python安装方式;可按当前官方说明选择Python官网安装包或Homebrew。
  2. 如果使用Homebrew,终端命令为brew install python3,前提是电脑已经安装并能运行Homebrew。
  3. 安装后重新打开Terminal,运行python3 --version和python3 -m pip --version。

结果判断:两个命令都能返回版本或路径即可继续。若python3存在但pip不可用,不要直接修改系统目录,先按Python Packaging User Guide的说明检查pip或在项目虚拟环境中操作。

Linux

  1. Linux发行版通常已经提供Python 3,但不同发行版的包管理命令和软件包名称可能不同。
  2. 优先使用当前发行版的包管理器安装Python和pip;安装后运行python3 --version。
  3. 如果pip缺失,先查看发行版文档或Python Packaging User Guide关于Linux包管理器的说明,不建议在系统Python上直接执行未经核验的安装脚本。

结果判断:系统能运行Python 3,并且项目环境可以创建venv。如果系统提示外部管理环境或权限不足,优先创建虚拟环境,而不是强行修改系统目录。

验证Python、pip并运行第一个程序

Python解释器、终端、编辑器和pip不是同一个东西:解释器负责运行代码,终端负责执行命令,编辑器负责编写文件,pip负责安装Python包。VS Code的Python扩展只提供编辑、运行和调试支持,并不包含Python解释器本身,具体关系可参考VS Code官方Python教程。

  1. 新建一个项目目录,例如hello-python,然后进入该目录。
  2. 新建文件hello.py,写入以下内容:print("Hello, Python!")。
  3. 在项目目录打开终端。Windows运行py hello.py;macOS或Linux运行python3 hello.py。
  4. 如果终端输出Hello, Python!,说明解释器、文件路径和基本运行流程均正常。

也可以安装VS Code和Python扩展。打开项目文件夹后,使用命令面板中的“Python: Select Interpreter”选择已安装的解释器,再点击编辑器右上角的运行按钮。若运行结果使用了错误版本,先重新选择解释器,再检查终端中的版本命令。

用venv创建项目独立环境,再安装依赖

虚拟环境用于把某个项目的依赖与系统Python、其他项目隔离。Python Packaging User Guide说明,venv可创建项目专用环境,能减少不同项目之间的包版本冲突。

  1. 在项目目录创建环境。Windows运行py -m venv .venv;macOS或Linux运行python3 -m venv .venv。
  2. 激活环境。Windows命令提示符运行.venv\Scripts\activate;macOS或Linux运行source .venv/bin/activate。PowerShell的激活命令可能受执行策略影响,以当前系统提示为准。
  3. 激活后再次运行版本检查命令。若终端提示符出现环境名称,或python -m pip --version显示路径位于项目的.venv目录,说明环境已生效。
  4. 安装依赖时使用当前解释器调用pip:Windows运行python -m pip install 包名或py -m pip install 包名;macOS/Linux运行python3 -m pip install 包名。
  5. 完成后运行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扩展。

相关阅读

参考资料

  1. Python官方下载页面
  2. Python For Beginners
  3. Python on Windows for beginners
  4. Python Packaging User Guide:Installing Packages
  5. Getting Started with Python in VS Code