Python 3.13 安装从零到通：PATH、pip镜像与OpenCV实战

先说个扎心的事实：我这两年在各种技术群里答疑，发现零基础同学学 Python 遇到的第一道坎，根本不是语法，也不是逻辑，而是“装环境”。下载了半天，双击安装包，点了一路“下一步”，最后兴冲冲打开命令行敲python，结果弹出一句“不是内部或外部命令”，当场就泄气了。其实安装 Python 这件事本身并不难，难的是没人把每一步的“为什么”讲清楚。

这篇教程就是冲着解决这个问题来的。我会用 2025 年最新的 Python 3.13 版本为例，从官网下载、安装器的关键勾选、环境变量配置，到 pip 换源、numpy / OpenCV 这些常用库的安装，再到常见报错的排错方法，全部串起来讲一遍。内容以 Windows 为主，macOS 和 Linux 会顺带提一嘴。不管你是完全没摸过 Python 的小白，还是之前装过但没成功、装完不知道怎么用的半新手，按这个流程走完，基本能一次搞定。

1. 动手之前：先弄清楚要装哪个 Python

1.1 版本到底怎么选，别盲目追新

很多同学上来就问“我该装 Python 3.8 还是 3.13”，或者听别人说“Python 3.8 最稳定”就去搜老版本。这里我得先说个基本逻辑：Python 官方每个大版本都有生命周期，老版本会陆续停止安全维护。你现在新学、新做项目，直接选当前最新的稳定版就行，今天的局面就是 3.13.x。至于网上常被提到的 3.8，那是很多老项目、老教程的环境，除非你公司有历史项目锁死版本，否则没必要一上来就装它。选新不选旧，对于新手永远是省事的。

还有一点容易忽略：Python 官网同时提供 32 位和 64 位的安装包。现在的电脑基本都是 64 位，直接选 64 位版本。如果你不确定自己的系统位数，右键“此电脑”→“属性”，在“系统类型”里能看到“基于 x64 的处理器”这类字样。装错位数不是不能用，但后面装某些科学计算库时会遇到“没有匹配版本”的诡异报错，所以第一步就选对。

另外提一句：别去下载预览版（比如后缀带 rc、beta 的版本）。预览版是给开发者测试新功能用的，不稳定，而且很多第三方库还没跟上。在官网下载页面里，认准标记为 “Stable” 的版本就行。搜索热词里经常有人搜 “python 3.8”，大概率是看了老教程，后面第 5 节我会讲一下老版本和全新版本在安装时的一个核心区别，你就明白为啥我劝你别折腾老版本了。

1.2 确认操作系统，安装包别下错

Windows、macOS、Linux 的安装包是完全不同的，这个看起来像废话，但我真见过有人把 macOS 的 pkg 包下载到 Windows 上，双击后一脸懵。下载之前先搞清楚自己是什么系统：

• Windows 10/11：最常见，本教程主线场景，下载 .exe 安装包。
• macOS：下载 .pkg，装完在终端里敲python3。
• Linux（如 Ubuntu）：一般用系统自带包管理器，比如sudo apt install python3，不用去官网下安装包。

判断系统很简单：Windows 用户在桌面右键“此电脑”→“属性”，能看到系统版本和位数；macOS 用户在左上角苹果图标→“关于本机”里看。这一步花不了 10 秒钟，但能帮你避开 90% 的“下错安装包”问题。macOS 和 Linux 的具体操作我在 5.4 小节单独说，新手先把 Windows 这条线走通即可。

1.3 这几种“Python”建议别装

第一次搜“python 下载”，大概率会看到一堆下载站、软件管家、一键安装包、公众号网盘资源。我的建议非常直接：能不碰就不碰。这些年我见过的坑包括：从非官方站下载的安装包被塞进全家桶软件；所谓“绿色版”解压后 PATH 环境变量一团乱；还有各种魔改版把 pip 指向奇怪的第三方源。最稳的做法只有一个：认准官方域名 python.org，从 Downloads 页面下载。官方下载慢的话，可以用国内机构同步的镜像站，但新手阶段直接官网下载就好，一般也就几十 MB，耐心等一下完全能接受。

另一个常见选择是系统自带的软件商店里的 Python。它的优点是安装简单，但缺点是版本更新滞后、安装位置和官方版不一样，很多教程里的路径和命令在你机器上会失效。对于想省事的零基础用户，我依然推荐官方安装包而不是商店版，因为网上 90% 的教程默认你用的是官方版。一句话：教程越多越通用的版本，才越适合新手。

2. 官网下载与安装：Windows 完整流程

2.1 从官网准确找到下载入口

打开浏览器，地址栏输入 python.org/downloads，注意拼写，别进到仿冒站或者各种推广站。进入后你能看到一个大大的黄色按钮写着 Download Python 3.13.x，直接点它就会下载 Windows 安装包。如果你用的不是 Windows，页面下方也有 macOS、Linux 对应的入口。文件下载下来一般是这个格式：python-3.13.x-amd64.exe，其中 amd64 表示 64 位，别看着 “amd” 就以为是 AMD 专用，Intel 电脑也用它。

这里多讲一个看版本号的小知识：3.13.x 里，3 是大版本，13 是次版本，x 是修订号，比如 3.13.1。官方会持续发布修订版修 bug，所以你下载到的可能是 3.13.1 或 3.13.2，这都正常。只要是大版本 3.13 就行。有些同学喜欢反复下载最新修订版，其实没必要，装好一个稳定可用就行。

2.2 安装器最关键的一步：勾选 PATH

双击 .exe 打开安装器，第一屏下方有两个复选框，其中第二个 “Add python.exe to PATH” 是整个安装流程里最重要的一项，没有之一。PATH 这个英文词看着高大上，其实可以理解成系统的“通讯录”：你在命令行里敲python，系统就翻开通讯录，去登记过的目录里找 python.exe。你勾选了这一项，就等于提前把 Python 登记进去了。很多人装完 Python 却打不开python命令，十有八九就是没勾这个选项。我建议所有零基础用户在这里停一下，确认它前面打勾了再继续。

第一屏还有一个选项是 “Install launcher for all users”，默认勾上就行，它的作用是给所有用户安装 Python 启动器，不影响使用。如果你想省心，点 “Install Now” 直接装到默认目录完全没问题。默认目录一般是 C:\Users\你的用户名\AppData\Local\Programs\Python\Python313，装在这里的好处是权限问题少，后面讲 pip 装库的时候你就知道省多少事了。

2.3 自定义安装：每个选项是干嘛的

如果你点的是 “Customize installation”，会看到几个可选功能，这里逐个解释一下：

• pip：Python 的包管理工具，负责安装第三方库，必装，别取消。
• tcl/tk and IDLE：图形界面开发环境 IDLE 的依赖，留着没坏处。
• Python test suite：标准库测试套件，普通用户用不到，但占空间很小，可以不管。
• py launcher：让命令行里可以直接用py命令启动 Python，建议保留。

再往下一屏是 “Advanced Options”，新手不用改太多，但有两个可以留意：一个是 “Install for all users”，勾上会装到 C:\Program Files 下，权限要求更高；另一个是自定义安装路径。我个人的建议是：默认路径就好。如果有人告诉你“路径不能有中文和空格”，那是老黄历了，现在的 Python 对路径兼容性已经很好，但为了后续某些第三方库少出幺蛾子，用默认路径仍然是最省心的选择。如果你非要改路径，也尽量选一个纯英文、不含空格的目录。

2.4 装完怎么确认成功：三行命令验证

安装进度条走完，先别急着高兴，打开验证一下。按 Win + R，输入 cmd 回车，打开命令行窗口，然后依次敲这三行：

python --version pip --version py --version

如果你能看到类似 Python 3.13.x、pip 25.x 这样的输出，恭喜，核心安装已经成功了。顺手再敲一个最简单的测试，直接在命令行里输入python回车，会进入一个 >>> 提示符，输入：

print("hello python")

回车后能看到 hello python 输出，再输入exit()回车退出。这就算把 Python 跑通了一次。注意，如果第三行py --version报错，别慌，说明 Python 装好了但 py 启动器没装全，不影响绝大多数使用，后面用python命令就行。

3. 环境变量：新手最容易卡住的地方

3.1 PATH 到底是个什么玩意

前面说了，PATH 可以理解成系统的通讯录。更准确一点：当你敲python，系统会在 PATH 里登记的一组目录里，按顺序找有没有 python.exe，找到就运行，找不到就报“不是内部或外部命令”。这个机制是不是听着很简单？对，就这么简单。但很多同学卡就卡在：不知道自己在装 Python 时没勾选 “Add to PATH”，也不知道命令行窗口要重开才能读到新配置。

这里再补充一个特别容易踩的坑：你在安装时勾选了 PATH，装完后如果之前已经开着一个命令行窗口，回到那个窗口敲python依然会报错。原因是环境变量是进程启动时读取的，旧窗口读的还是旧配置。解决办法就是关掉命令行窗口重新开一个，所有教程里说的“重新打开终端”，底层原理就是这一个。

3.2 手动配置 PATH 的完整步骤

假如你安装时漏勾了 PATH，或者运气不好用了某个魔改版，那就手动配。具体步骤如下，Windows 10/11 通用：

1. 桌面右键“此电脑”或“我的电脑”→“属性”。
2. 左侧点“高级系统设置”→“环境变量”。
3. 在“用户变量”列表里找到 Path，选中后点“编辑”。
4. 点“新建”，把 Python 的安装目录粘贴进去，例如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python313。
5. 再新建一条，粘贴同目录下的 Scripts 子目录，例如 ...\Python313\Scripts，这是 pip 等命令行工具的位置。
6. 全部确定后，重新开一个命令行窗口，敲python --version验证。

需要提醒一句：编辑环境变量时，尽量改“用户变量”里的 Path，别去动“系统变量”。用户变量只管你自己，系统变量影响整台电脑。新手手滑在系统变量里删错东西，可能导致其他软件打不开，属实没必要冒险。

3.3 给 pip 配个国内镜像源，装库快十倍

Python 装好之后，你会接触到一个叫 pip 的工具。它相当于 Python 生态里的“应用商店”，你在命令行里敲pip install numpy，它就从 PyPI（Python 官方包仓库）下载 numpy 库。问题在于 PyPI 默认服务器在国外，国内网络环境下下载经常几十 KB/s，甚至直接超时。解决方案是配置国内镜像源。

临时使用的话，在 pip install 后面加一个参数就行：

pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

想一劳永逸，让以后所有 pip 安装都默认走镜像，执行一次配置命令：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

清华源、阿里云源、豆瓣源都可以，选一个稳定的就行。我自己的习惯是用清华源，因为更新比较及时。配置完再装库，速度基本是秒开。另外提醒一句：如果你在公司内网环境，有时候走镜像反而会被拦截，那时再临时去掉-i参数回退到官方源试试。

3.4 写第一段代码：从命令行到 .py 文件

很多新手有一个困惑：我在命令行里敲了几行代码，关掉窗口就没了，那写程序到底写在哪儿？答案是：把代码保存成扩展名为 .py 的文件，再用python运行它。这个理解一旦建立，你对 Python 的认识就清楚了一半。

具体操作：随便建一个文件夹，比如 C:\pycode，在里面新建一个文本文件，把文件名连同扩展名一起改成 hello.py，然后用记事本或后面的 VS Code 打开，写入一行代码：

print("hello python")

保存后，在命令行里先cd到那个目录，再敲python hello.py，你就会看到程序运行结果。这里先不深入讲语法，重点是建立起“写文件 → 运行文件”的工作流。至于在电脑上写代码用什么工具最顺，我在第 6 节专门讲 VS Code 的配置。

4. 常用库安装实操：numpy、pandas、OpenCV、sklearn 一把过

4.1 搞清楚 pip 安装库的原理，你就不会乱装

搜索热词里有一堆这样的问题：python 安装 numpy 库的方法、python 安装 sklearn 库、python 下载 cv2。其实这些问题本质上是同一个问题：怎么用 pip 安装第三方库。第三方库就是别人写好的、打包好放到 PyPI 上的代码，你pip install一敲，pip 会连同一个文件清单下载解压并装进你的 Python 环境，之后你在代码里import就能用。

这里有个关键概念要建立：每个第三方库都针对特定 Python 版本和操作系统发布对应版本。Python 新版本出来后，热门库通常几周内就会跟进，但冷门库可能要等几个月。这也是我前面劝你选新版稳定版、不要追预览版的原因。比如你装了 Python 3.13 预览版，某个库只支持到 3.12，pip 就会报“找不到匹配版本”，你还以为是操作问题，其实是版本兼容问题。

4.2 科学计算几件套与图像库的安装命令

新手最常用的几个库，安装命令我给你整理成一组：

pip install numpy pandas scikit-learn pip install opencv-python pip install matplotlib

注意一个经典坑：OpenCV 在 Python 里 import 的名字是cv2，但 pip 安装的包名是opencv-python。如果你搜“python 下载 cv2”，照着去pip install cv2，大概率会安装一个不相关的同名包，或者在最新版本下直接报错。记住：功能是cv2，包名是opencv-python，这个对应关系经常有人栽。

安装完成后，怎么确认真的装好了？在命令行里依次执行：

python -c "import numpy; print(numpy.__version__)" python -c "import cv2; print(cv2.__version__)"

没报错、输出版本号，就说明库已经可以用了。很多人喜欢看到一堆安装日志就以为成功了，其实最靠谱的方式就是import验证。这一步花 30 秒，能省掉你后面写代码时的各种 “No module named”。

4.3 装库报错的四种排错套路

pip 装库失败是新手最崩溃的场面，但总结下来无非四类：

第一类，pip 版本太旧，报错里出现 “you should consider upgrading via”。解决办法是执行：

python -m pip install --upgrade pip

第二类，网络超时或者下载慢。优先检查镜像源有没有配置；也可以临时加长超时时间：

pip install numpy --timeout 120 -i https://pypi.tuna.tsinghua.edu.cn/simple

第三类，权限报错，比如出现 “Permission denied”。这通常说明你的 Python 装在需要管理员权限的位置。新手最简单的方式是用pip install --user把库装在用户目录下，或者干脆重装 Python 到默认路径（前面说的坑就在这里体现）。

第四类，编译类错误，比如缺少 Visual C++ 构建工具，常见于一些老库或特殊平台库。碰到这种问题，先去 PyPI 对应页面找有没有 .whl 预编译包，或者搜索“库名 + 版本 + win_amd64.whl”，下载后用pip install 文件名.whl安装。这四类覆盖了至少九成的新手报错，剩下的多在技术社区里搜一下报错原文就能找到答案。

4.4 库里装多了会乱？聊聊环境隔离

等你会装几个库之后，会遇到另一个问题：库和库之间有版本要求冲突。比如项目 A 要用 numpy 1.x，项目 B 要用 numpy 2.x，直接装在同一个 Python 里，早晚打架。解决办法是虚拟环境，底层原理就是创建多个互相隔离的 Python 环境，每个环境有自己的库列表。

执行起来非常简单，venv 是 Python 自带的模块，不需要额外安装：

python -m venv myenv

这会在当前目录生成一个 myenv 文件夹，里面是一套独立的 Python。要使用它，Windows 下激活命令是：

myenv\Scripts\activate

激活后命令行前面会出现 (myenv) 字样，这时候你pip install的任何库都只装在这个环境里，不影响全局 Python。新手阶段可以不深究，但如果你打算长期写 Python，我建议从第一次正经做项目起就养成用虚拟环境的习惯。量化交易、爬虫这些容易装一堆库的方向，尤其需要这个习惯。

5. 常见报错与排错实战速查表

5.1 “‘python’ 不是内部或外部命令”的完整排查链

这是所有 Python 安装教程里被问最多的一句话。碰到它，按下面的顺序排查：

• 安装时有没有勾选 Add python.exe to PATH？没有就按 3.2 节手动配。
• 环境变量改完之后，命令行窗口有没有重新打开？旧窗口不认新配置。
• python 是否真的装进系统了？去安装目录里看有没有 python.exe 文件。
• 是不是在某个特殊终端里？比如 PowerShell 和 CMD 某些情况下 PATH 同步延迟，重启一次电脑最保险。

你可以把这个当口诀记：先看勾选，再看重启，再看文件是否存在。三步走完，九成问题都能解决。剩下的一成，多半是装了多个版本 Python，命令被旧版本抢先“认领”了，这种情况用py --version看看到底是哪个版本在响应，必要时把多余的版本卸掉。

5.2 pip 常见报错与对应解法

除了python命令找不到，pip 相关的报错也是高频问题。我把几个最典型的列成一张表：

这里特别说一下 SSL 报错。它的原因通常是电脑的网络环境对证书校验比较严格，或者走了某些代理。新手最简单的处理方式不是去研究证书，而是把默认源换成国内镜像，很多 SSL 问题在换源后就自然消失了。如果临时想绕过证书校验，可以在命令里加：

pip install numpy --trusted-host pypi.org --trusted-host files.pythonhosted.org

但要注意这只是一个临时手段，不建议长期用。

5.3 卸载重装：把环境清干净的正确姿势

有些同学折腾了半天，PATH 也不知道改成了什么样，最后决定推倒重来。这个决定其实挺明智的，但“重装”也有讲究，否则越卸越乱。正确顺序是：

1. 打开“控制面板”→“程序和功能”，找到 Python，点卸载。
2. 卸载后检查环境变量 Path，把残留的 Python 相关目录删掉，避免新版本被旧路径干扰。
3. 清理旧版本留下的缓存目录，一般是 C:\Users\用户名\AppData\Local\Programs\Python，以及 %LOCALAPPDATA%\pip 下的缓存。
4. 重新下载最新稳定版安装包，按第 2 节的流程一步步来。

很多新手在第一步就顺手把 Python 的安装目录整个手动删除了，结果控制面板里卸载程序找不到目标，反而留下了一堆零散文件。我的建议是：先走控制面板卸载，再手动清理残留，顺序不要反。

5.4 macOS 和 Linux 上的安装速览

虽然本教程主线是 Windows，但考虑到很多同学后面会用到云服务器或者自己的 Mac，这节简单说几句。macOS 上最简单的方式是去官网下载 .pkg 安装包，双击按提示安装，之后在终端里敲pip3或python3，注意多了一个数字 3，因为 macOS 自带一个老版本 Python。Linux（以 Ubuntu 为例）通常不推荐从官网下安装包，而是用系统包管理器：

sudo apt update sudo apt install python3 python3-pip

装完一样验证python3 --version和pip3 --version。macOS 和 Linux 上 PATH 的配置文件和 Windows 不同，新手阶段建议直接用pip3操作，等以后熟练了再研究虚拟环境和版本管理工具。要注意的是，无论哪个系统，都别在系统自带的 Python 里乱装全局库，否则容易搞坏系统工具，这也是我反复强调虚拟环境的原因。

6. 装完之后：给零基础新手的下一步建议

6.1 第一个小练习：从计算长方体体积开始

环境装好后，最大的误区是继续刷安装教程，而不是赶紧写代码。我建议你立刻做一个两位数都能明白的小任务：写一个 Python 程序，输入长、宽、高，输出长方体体积。代码可以这样写：

length = float(input("请输入长：")) width = float(input("请输入宽：")) height = float(input("请输入高：")) volume = length * width * height print("长方体体积是：", volume)

保存成 cuboid.py，运行它，程序会在屏幕上等你输入三个数字。这个过程能让你一口气体会变量、函数、输入输出、类型转换这几个最基础的概念，比背十页语法有用得多。而且这个任务小到不会有挫败感，又真实到能建立“我能用 Python 解决实际小问题”的信心。

6.2 编辑器选择与 VS Code 环境配置

记事本写代码虽然能跑，但体验太原始，没有语法高亮、没有自动补全，报错了也看不出问题在哪。新手阶段我更推荐 VS Code，免费、轻量、生态大。安装 VS Code 后，再配 Python 环境只需要几步：

1. 在 VS Code 扩展市场搜索 “Python”，安装微软官方插件。
2. 打开任意一个 .py 文件，按 Ctrl+Shift+P，输入 “Python: Select Interpreter”，选择你刚安装的 Python 版本。
3. 左下角出现 Python 版本号，说明解释器已关联，直接按右上角的运行三角就能执行代码。

这一步的核心是“选择解释器”。很多新手在 VS Code 里写完代码点运行，却提示找不到模块，多半是 VS Code 选择了另一个 Python 环境。尤其是装了多个版本或者用过虚拟环境后，检查解释器总是排错的第一步。思维模型很简单：写代码的软件（VS Code）和执行代码的解释器（Python）是两个东西，得手动指定它们配对。

6.3 后续还能往哪些方向走

环境跑通之后，你可以按兴趣挑一个方向往下走。热度很高的几个方向里，数据分析方向需要 pandas 和 matplotlib，初学画图时经常会遇到横坐标太密集、挤成一团的问题，这时候一句plt.xticks(rotation=45)就能让标签旋转 45 度，比到处查代码快得多。自动化办公方向会用到连接各类数据源、批量处理 Excel 等；量化交易方向则会用到数据获取、回测这类模块。不管哪个方向，前提都是环境稳定、依赖库装得顺，而这些东西恰恰是本文前面几节帮你打好的底子。

我自己带过很多零基础同学，观察到一个普遍规律：凡是安装环节走得踏实的，后面学语法、做小项目都顺；凡是环境一塌糊涂、装了三遍还有问题的，往往还没开始写代码就放弃了。所以这篇文章虽然只讲安装，我却觉得它是你 Python 之路最值得认真看的一篇。按这个流程装好之后，别急着再研究别的工具链，先写 20 个像长方体体积这样的小程序，让“写文件—运行—改错—再运行”这个循环成为肌肉记忆，再谈下一步。

最后再分享一个我个人觉得很有用的笨办法：如果你安装过程中反复卡住，与其到处问人，不如把安装、配置、验证每一步都截图存下来，然后卸载重装一遍。重装一次，你看那些勾选框和路径的感觉会和第一次完全不一样。环境这件事，亲手做一遍胜过看十遍教程。