装 Python 这事儿,说难不难,说简单吧,群里天天有人卡在半路。我见过太多新手兴冲冲下载了安装包,结果双击之后一路 Next,最后在命令行敲python却提示不是内部命令,又或者装了 Python 但 IDE 里根本识别不到解释器,直接心态爆炸。这篇文章就把我从零开始装 Python 的完整思路、每一步的操作逻辑、以及那些年踩过的坑,一次性和你说清楚。不管你是 Windows、macOS 还是 Linux,看完都能把环境跑起来,并且知道怎么装第三方库、怎么配 VS Code / PyCharm,最后还能自己排查最常见的报错。
先说结论:Python 本身完全免费,官方直接下载,不需要破解、不需要付费、也不需要去找什么“公众号后台回复 xxx 获取安装包”。你要做的就三件事:下载合适的安装包、安装时勾对一个选项、装完之后验证一下。剩下那些花里胡哨的配置,都是后续慢慢补的,别想一口吃成胖子。
1. 安装前必须想明白的三件事
很多新手容易忽略,装 Python 之前其实有三个问题要想清楚,否则后面大概率返工。
1.1 到底装哪个版本,是不是越新越好
Python 的版本号现在看起来有点乱,什么 3.8、3.10、3.11、3.12、3.13,还有一堆小版本。我的建议很简单:去官网看当前最新的稳定版,下载那个“Latest Python 3 Release”。比如写这篇文章的时候,3.13 系列就是当前主力,那就直接用 3.13.x。
为什么我不推荐装 3.8、3.9 这种老版本?因为新版本在性能、语法、错误提示上都有明显改进,比如 3.11 之后启动速度和运行效率提升了一大截,3.12 的错误提示更友好。除非你有明确的原因必须用老版本——比如公司项目锁定版本、某个第三方库还没适配新版——否则新手直接上最新稳定版就行。
这里有个反面例子:有些教程让你装 2.7,说资料多、兼容好,千万别信,Python 2 早就停止维护了,学它等于学了一门退役语言,很多新库根本不支持。你搜资料的时候发现代码风格都不一样,纯属给自己添堵。
1.2 64 位和 32 位怎么选
这个其实不用纠结太久,现在 99% 的电脑都是 64 位系统,Windows 下直接选 64-bit 安装包。怎么看自己系统位数?右键“此电脑”选“属性”,在“系统类型”那一栏能看到。
如果你用的是老古董 32 位系统,那就只能选 32-bit 版本了,不过这种情况下我建议你优先考虑换电脑,而不是换 Python 版本,因为现在很多库对 32 位支持越来越差,装个 numpy 都能卡半天。
1.3 官网下载还是国内镜像,其实差别不大
Python 官网(python.org)的下载速度在国内有时候会比较慢,尤其是高峰期。如果你发现官网下载慢得让人抓狂,可以去国内高校镜像站,比如清华 TUNA、阿里云镜像,里面都有 Python 安装包的镜像。
但我要提醒一点:去镜像站下载没问题,千万别去那些不知名的小网站下载所谓的“Python 中文版”、“Python 绿色版”。安装包这种东西被植入后门不是没发生过,你后面要用它跑各种脚本,等于把电脑的钥匙交出去了。安全第一,官网慢一点就慢一点,或者用我上面说的镜像站,都是正规渠道。
2. Windows 安装全流程实操
Windows 用户是最多的,所以这部分我写细一点,每一步都告诉你为什么要这么做。
2.1 下载安装包的正确姿势
打开浏览器,访问 python.org/downloads,网站会自动识别你的操作系统,弹出一个黄色大按钮,上面写着 “Download Python 3.x.x”,直接点它就能下载 Windows 安装包。
如果你用的是 Windows 7 或者更老的系统,注意看官网页面上可能会提示这个版本不支持老系统,需要去别的页面找适配版本。Windows 7 用户最高只能装到 Python 3.8 左右,这一点要心里有数。要是你还在用 Windows 7,我建议你优先考虑升级系统,不然很多开发工具都用不了。
下载完成之后你会得到一个 .exe 文件,文件名类似python-3.13.x-amd64.exe。在双击之前,先看一眼文件大小,正常应该在 25MB 左右,如果只有几 MB,八成是下载过程出问题了,别急着装,重新下载。
2.2 安装时最关键的一步:勾选 Add Python to PATH
双击安装包之后,第一个界面会出现两个选项:一个是 “Install Now”,一个是 “Customize installation”。很多人都是直接点 “Install Now”,然后就悲剧了。
正确做法是:注意界面的最下方,有一个复选框 “Add Python to PATH”,先把这一项勾上!这个操作的意思是让系统在全局命令里登记 Python 的位置,这样你之后在命令行敲python才能直接识别。如果没有勾选,你装完之后在命令行输入 python,系统会一头雾水地提示“不是内部或外部命令”。
然后我建议你点 “Customize installation”,不是因为它有多高级,而是因为这里可以改安装路径。默认的安装路径是当前用户的 AppData 目录,路径里可能有中文用户名或者很深的目录结构,后面有些库编译的时候会因为这个出问题。自定义安装路径选一个简单的位置,比如D:\Python313或者C:\Python313,别带中文、别带空格、别放在桌面。
后面几个选项页面,比如 Optional Features 和 Advanced Options,保持默认就行,注意 Advanced Options 里 “Install for all users” 如果你想勾选也可以,勾了之后要以管理员身份运行安装程序。大多数情况下默认配置已经够用了,不用纠结。
2.3 安装完成后如何验证
安装完成后,按Win + R打开运行对话框,输入cmd回车,打开命令行窗口。然后输入:
python --version如果输出类似Python 3.13.x,说明安装成功,PATH 也没问题。再输入:
pip --versionpip 是 Python 自带的包管理工具,如果这一条也正常输出版本号,那你的环境基本就齐活了。
如果python --version报错,或者弹出了 Microsoft Store 的页面,说明 PATH 配置有问题。Microsoft Store 那个提示“Python was not found; run without arguments to install from the Microsoft Store”,是一个典型的坑,我后面专门讲怎么处理。
提示:我装完之后习惯再敲一句
python -c "print('hello')",如果输出 hello,就说明解释器真的能跑,比只看版本号更踏实。
2.4 验证 PATH 的底层逻辑
为什么 PATH 这么重要?你可以把 PATH 理解成一个通讯录,你输入python的时候,系统会按照通讯录里登记的地址挨个去找名为python.exe的文件,找到了就运行,找不到就报错。如果没有把 Python 的安装目录加进这个“通讯录”,就算你电脑里装了一百个 Python,系统也一个都找不到。
如果安装时忘了勾选 Add Python to PATH,补救方法有两个。第一个是重装一遍,运行时勾上,简单粗暴;第二个是手动添加环境变量:右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量,在系统变量的 Path 里新建两条,一条填 Python 安装目录,比如D:\Python313,一条填它的Scripts子目录,比如D:\Python313\Scripts。Scripts 目录是 pip 安装命令行工具时要用的,不配的话后面有些库的命令用不了。
3. macOS 和 Linux 安装差异
macOS 和 Linux 用户虽然没 Windows 那么多,但这个群体里新手也不少。这两个系统的环境管理逻辑和 Windows 不太一样,我给你说几个关键点。
3.1 macOS 安装的两种方式
macOS 上安装 Python,我见过两条路线。简单路线是去官网下载 macOS 版本的 pkg 安装包,双击一路下一步就装好了。装完之后打开终端,输入python3 --version就能验证。
但 macOS 用户要注意一件事:双击安装完成后,建议去“应用程序”文件夹里找到 Python 3.x 目录,双击运行 “Install Certificates.command” 这个脚本。它的作用是安装 SSL 证书,如果不跑这个脚本,后面你用 pip 从网上安装第三方库的时候,很可能报一个certificate verify failed的错。这个细节是官方安装包说明里提过的,但 90% 的人装完直接忽略,等真正报错才回来补。
第二条路线是用 Homebrew,这是 macOS 上的包管理器。安装命令是:
brew install python用 Homebrew 的好处是后续更新方便,brew upgrade python就能升级。坏处是 Homebrew 装的 Python 和系统自带的 Python 容易让人混淆。系统自带的那个 Python 2 或老版本 Python 3,千万不要动它,那是 macOS 系统本身依赖的,删了系统可能出问题。你自己要用的一律用 Homebrew 装的版本。
3.2 Linux 安装:优先用系统包管理器
大多数 Linux 发行版默认自带 Python 3,但版本可能偏老。比如 Ubuntu 22.04 自带 Python 3.10,Ubuntu 24.04 自带 3.12,对大多数场景来说其实够用了。如果你需要最新的 Python,建议用包管理器安装,不要到官网下载源码编译。
Ubuntu / Debian 系安装 Python 的命令:
sudo apt update sudo apt install python3 python3-pipCentOS / RHEL / Fedora 系用:
sudo dnf install python3 python3-pip注意 Linux 下安装的 Python 命令通常叫python3,带个数字后缀。如果你敲python可能没有反应,这是正常现象,因为很多发行版把python这个命令留给了 Python 2 或者干脆不设置。你可以自己做个别名映射,也可以直接习惯用python3。
如果你真的需要从源码编译安装新版本,比如装 Python 3.13,那就要注意装编译依赖。核心依赖包括build-essential、libssl-dev、zlib1g-dev、libffi-dev等,少了这些东西,编译出来的 Python 可能缺少关键模块,比如没有ssl模块,你后面连 pip 都用不了。我踩过一次这个坑,编译完才发现 ConfigParser 和 ssl 全挂了,只能重新装依赖再编译一遍,非常浪费时间。所以要么你用官方包管理器,要么就把依赖一次性装全。
4. 编辑器配置:VS Code 和 PyCharm 二选一
装完 Python 解释器只是第一步,你还得有个趁手的“本子”来写代码。这里有个非常重要的概念要区分清楚:Python 本身是解释器,负责运行代码;编辑器只是帮你写代码的工具,两者是两个独立的软件。
4.1 新手到底选 VS Code 还是 PyCharm
这个问题被问了几百遍,我的答案是:都可以,但选择逻辑不一样。
VS Code 的优势是轻量、免费、插件生态丰富,不管是写 Python、写前端还是写别的语言,一个工具通吃。缺点是配置门槛稍高,你得自己装 Python 扩展,自己选解释器,对完全零基础的人来说,多了一步就是多了一个坑。
PyCharm 的优势是专为 Python 设计,安装完基本零配置就能跑,很多功能开箱即用。缺点是社区版功能有限,专业版收费,而且如果你后面不写 Python 了,这个工具的利用率就很低。
我的建议是:如果你确定自己就是要把 Python 学下去,而且想要省心的体验,直接上 PyCharm Community 版;如果你想一个编辑器走天下,选 VS Code,一次性配置好以后受益。
4.2 VS Code 配置 Python 环境的完整步骤
VS Code 的配置其实不复杂,跟着做一遍就懂了。
第一步:去 code.visualstudio.com 下载安装 VS Code,双击安装,一路 Next。注意安装过程中有一个“添加到 PATH”的选项,建议勾选,这样你之后可以在终端直接敲code命令打开编辑器,非常方便。
第二步:打开 VS Code,左侧栏有个方块图标,那是扩展市场。在搜索框里输入Python,找到由 Microsoft 发布的那个扩展(名字就叫 Python,发布者显示为 Microsoft),点击安装。这个扩展是 Python 语言支持的核心,包括代码提示、语法高亮、调试等功能都靠它。
第三步:按下Ctrl + Shift + P打开命令面板,输入Python: Select Interpreter,回车。这时候会列出你电脑上已经检测到的 Python 解释器,选择你刚安装的那个版本。如果没有出现任何解释器,说明 VS Code 没找到你的 Python,这时候检查一下是不是没把 Python 加到 PATH。
第四步:新建一个文件,把后缀名保存为.py,比如hello.py,输入:
print("hello python")然后点右上角的三角形运行按钮,如果下方终端输出hello python,说明整个链路通了。
提示:VS Code 里如果代码提示不出现,绝大多数原因是解释器没选对。你可以在 VS Code 右下角状态栏看到当前使用的解释器路径,那个地方也可以快速切换解释器。
4.3 PyCharm 配置环境的最短路径
PyCharm 的配置流程更简单。下载 Community 版,安装后新建项目,注意在新建项目界面有一个“Previously configured interpreter”选项,选择它,然后指定你的 Python 解释器路径。如果你没有特殊需求,直接让它用默认的 New environment 也行,PyCharm 会帮你创建一个虚拟环境。
PyCharm 的优势在它的调试功能特别直观,你可以在代码行号旁边点一下设置断点,然后按调试按钮,程序会在那一行停下来,你可以逐行查看每个变量的值,这对新手理解代码执行流程帮助巨大。VS Code 也有调试功能,但 PyCharm 的可视化做得更友好。
5. 第三方库安装与虚拟环境
Python 能火,很大程度上靠的是海量的第三方库,比如做数据分析的 pandas、numpy,做爬虫的 requests、BeautifulSoup,做可视化的 matplotlib,做界面的 flet。这些库都要靠 pip 来安装,所以 pip 能不能用、装库的姿势对不对,直接关系到你能不能顺利写下去。
5.1 pip 换源:解决的其实是下载速度
pip 默认从官方源下载,服务器在国外,国内网络环境下经常慢到让人怀疑人生,甚至直接超时。解决办法是换成国内镜像源,比如清华、阿里、豆瓣,原理就是把下载地址改成国内服务器,速度提升是几十倍的差别。
一次性的换源方式是在命令后面加上-i参数:
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple更推荐的方式是永久配置,Windows 下在用户目录创建pip文件夹,里面放一个pip.ini文件,内容写上:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple trusted-host = pypi.tuna.tsinghua.edu.cnmacOS / Linux 则是在用户目录创建.pip/pip.conf,内容一样。配好之后你再敲pip install xxx,就默认走国内镜像了,速度飞快。
5.2 用 pip 装库的完整逻辑和典型例子
装库的命令很简单:
pip install 库名指定版本可以用==,比如pip install numpy==1.26.0;批量安装可以用pip install -r requirements.txt,这在后面做项目部署的时候特别实用。
给你三个真实场景。第一个是装 numpy,这是 Python 数值计算的基础库,你可能在看一些数据分析教程时第一行 import numpy 就报错,其实就是没装这个库。装完方法:
pip install numpy第二个是装 OpenCV 的 Python 接口,你在搜“python下载cv2”的时候会找到一堆资料,其实命令就一行:
pip install opencv-python装完之后 import 的时候写import cv2,这是很多人踩过的坑,以为要 import opencv,其实库名和 import 名称不是一回事。
第三个是装 flet,这个库能让 Python 快速开发跨平台 GUI 应用,甚至还能打包成 APK 跑到手机上,对新奇玩法感兴趣的同学可以关注一下:
pip install flet装库之后如果提示Requirement already satisfied,说明你已经装过这个库了,不用重复操作;如果提示Could not find a version that satisfies the requirement,先检查一下库名是不是拼错了,再看一下版本兼容性。
5.3 虚拟环境:后面一定会用到的东西
很多新手一开始不理解虚拟环境这个东西,觉得多此一举。打个比方:你的电脑就像一个公共厨房,Python 是公共灶台,每个项目是不同的大厨。如果每个大厨都把食材随手放在台面上,厨房很快就乱了。虚拟环境就是给每个项目分配一个独立的储物柜,各用各的,互不干扰。
创建虚拟环境的命令极其简单,Python 3.3 以后自带 venv 模块:
python -m venv myenv这会在当前目录创建一个myenv文件夹,里面装着这个项目专属的 Python 环境。怎么激活它?
Windows 下运行:
myenv\Scripts\activatemacOS / Linux 下运行:
source myenv/bin/activate激活之后,你再使用 pip 安装任何东西,都不会污染全局环境。如果你的项目里 A 需要 numpy 1.24,B 需要 numpy 1.26,各自开一个虚拟环境互不干扰,这就是虚拟环境的最大价值。我建议你从第一个正式项目开始就养成用虚拟环境的习惯,等后面真的遇到依赖冲突再回来学,会非常痛苦。
6. 新手必踩的坑:常见报错排查
这部分我把这几年帮人解决 Python 环境问题时遇到的高频报错汇总成一张排查表,你如果遇到类似问题直接对照着看就行。
6.1 高频报错与对应解决方案
| 报错信息 | 出现场景 | 解决办法 |
|---|---|---|
'python' 不是内部或外部命令 | 在 cmd 中输入 python 报错 | 没有将 Python 加入 PATH,重装时勾选 Add Python to PATH,或手动配置环境变量 |
Python was not found; run without arguments to install from the Microsoft Store | Windows 输入 python 弹出微软商店 | 系统应用执行别名劫持了命令,去“设置 -> 应用 -> 高级应用设置 -> 应用执行别名”里关闭 python.exe 和 python3.exe 的别名 |
pip 不是内部或外部命令 | 输入 pip 报错 | 检查 Python 安装目录下的 Scripts 文件夹是否加入 PATH,或者重装 Python 并勾选 pip 组件 |
WARNING: You are using pip version xx, however version yy is available | 使用 pip 时弹出提示 | 不影响使用,可以执行python -m pip install --upgrade pip升级 pip |
Could not find a version that satisfies the requirement | 安装某个库时报错 | 检查库名拼写、Python 版本是否兼容、网络是否正常,必要时换国内源 |
ReadTimeoutError或Connection broken | pip 安装库超时 | 大概率是网络问题,换国内镜像源,或者把超时时间调大:pip install xxx --timeout 120 |
ModuleNotFoundError: No module named 'xxx' | 运行 Python 脚本时报错 | 当前环境没有安装对应库,执行pip install xxx |
SSL: CERTIFICATE_VERIFY_FAILED | macOS 下 pip 或脚本请求网络时报错 | 运行 Python 安装目录下的 Install Certificates.command,或参考官方文档重装证书 |
UnicodeDecodeError: 'gbk' codec can't decode byte | 读取文件时中文乱码 | 文件编码问题,用open(文件名, encoding='utf-8')明确指定编码,或把文件另存为 UTF-8 格式 |
6.2 一个容易忽视的系统级坑:应用执行别名
Windows 上有个特别坑的机制叫“应用执行别名”,它会让你输入python的时候直接跳转到 Microsoft Store 的 Python 下载页面。明明你已经装好了 Python,但输入 python 却弹出商店界面,很多人在这卡了半天。
解决办法是:打开 Windows 设置 -> 应用 -> 高级应用设置 -> 应用执行别名,找到python.exe和python3.exe两个选项,把它们关掉。这个操作的本质是撤销系统对 python 命令的“劫持”,让你的命令真正执行到自己的 Python 解释器。
6.3 关于卸载 Python 的提醒
如果实在装坏了要卸载,我给你三个建议。第一,尽量不要手动删除 Python 安装目录,而是通过系统的“添加或删除程序”正常卸载,不然一堆残留文件后面看着就烦。第二,卸载前先把环境变量里和 Python 相关的记录清理掉,不然 PATH 里留着一条指向不存在目录的路径虽然不会报错,但会让系统搜索更慢。第三,如果你的项目里用了虚拟环境,卸载前先备份虚拟环境里的requirements.txt:
pip freeze > requirements.txt这样重装之后一条命令就能把所有依赖恢复回来,不用一个个重新梳理。
最后一个建议:先跑起来,再追求完美
环境装好之后,最重要的不是立刻去看什么高深语法,而是先让代码跑起来。哪怕只是打印一段文字、算两个数,亲眼看到结果的那一刻,你才算真正迈进了 Python 的大门。
我个人的习惯是,新环境装完之后第一件事是跑一段小脚本,把常用的几类操作都验证一遍:打印、网络请求、文件读写、第三方库导入。全跑通了,心里就踏实了,后面写代码的时候也不会老怀疑是环境出了问题。
等你把环境弄得滚瓜烂熟,再去看爬虫、数据分析、自动化办公这些方向,都会顺手很多。很多人学不会 Python,其实不是理解力问题,而是 80% 的精力都消耗在了环境搭建和报错排查上。这篇文章帮你把路铺平了,接下来就看你自己走了。如果哪里还有问题,欢迎在评论区把你遇到的报错原样贴出来,我看到了会回复。