一、场景引入先建厨房再学做菜写 Python 代码之前得先把两样东西装好解释器和编辑器。很多新手在这第一步就被劝退装了编辑器却运行不了代码、命令行里敲python没反应、或者莫名弹出微软商店。这一篇就是来解决它们的——按顺序做10 分钟内你会得到一个能运行 Python 的解释器Anaconda自带后文要用的常用库一个好用的代码编辑器VS Code一份环境体检报告脚本随时确认环境是否正常。二、本篇目标装好 Anaconda含 Python 解释器 常用库装好 VS Code含 Python 扩展运行本篇配套的验证环境.py看到体检报告显示可以开始第 2 篇。不需要写任何代码只需要点鼠标和复制粘贴。三、知识点讲解3.1 解释器和编辑器是什么关系一次讲清后面不再迷糊用一个比喻编辑器VS Code稿纸。让你写得舒服有代码高亮、自动缩进、拼写提示。它自己不会运行代码。**解释器Python**执行者。负责把你写的每一行代码翻译成电脑的动作。我们真正学 Python学的是怎么给这位执行者下指令。pip / conda应用商店。以后要处理 Excel、发邮件就去商店装对应的工具库。三者关系一句话你在稿纸VS Code上写代码稿纸把文件递给执行者Python去跑跑的过程中缺什么工具就通过商店pip去装。新手 90% 的环境问题本质都是这三者没接上线稿纸找不到执行者没选解释器、命令行找不到执行者没加 PATH、执行者找错了人电脑里有多个 Python。记住这句话后面排查报错会反复用到。3.2 为什么选 Anaconda而不是官网直装 PythonAnaconda 是一个Python 大礼包解释器 几百个常用库 环境管理工具一次装齐。对学本专栏的三个好处后面办公自动化要用的 pandas、openpyxl、matplotlib 等Anaconda自带不用一篇篇手动装以后项目多了比如爬虫一套环境、AI 一套环境它自带的环境管理能互不打架安装器会顺手配置好大部分东西新手第一次成功率最高。代价安装包约 1GB占 3~4GB 磁盘。老电脑或 C 盘紧张的同学可以用Miniconda同一家的精简版只有裸解释器几十 MB库用到再装本篇步骤完全通用。说明框python.org 官网直装也完全可以更轻量。但需要自己手动勾选 PATH、再逐个 pip 安装库第一次装最容易翻车。本专栏统一用 Anaconda 讲解已在用官网版 Python 的同学也不用重装——版本满足 3.10 即可继续跟。版本说明Anaconda 每年更新多次近期版本内置 Python 3.11~3.13。不用纠结具体小版本号本专栏任何 Python 3.10 及以上都适用。3.3 第一步安装 AnacondaWindows1. 下载官网www.anaconda.com/download需要填邮箱且国内访问慢。推荐直接用清华镜像速度拉满打开https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/点击 File Name 后的 ↓ 倒序显示找文件名形如Anaconda3-5.3.1-Windows-x86_64.exe的最新版认准Windows-x86_64.exe结尾Mac 用户选MacOS-x86_64.pkgIntel 芯片或MacOS-arm64.pkgM 系列芯片。2. 安装重点看勾选项双击安装包Select Installation Type选Just Me不需要管理员权限最省事Choose Install Location默认路径即可。唯一要求路径里不要有中文和空格默认C:\Users\你的用户名\anaconda3符合要求Advanced Options勾选Add Anaconda3 to my PATH environment variable。这一步最重要——勾了它以后在任何命令行里输入python都能直接用。官方提示不推荐是担心和电脑里已有的其他 Python 冲突对新手来说利大于弊放心勾。第二个选项 Clear the package cache 保持默认即可。等待安装完成装完点掉两个 Finish 页的了解 Anaconda选项即可3. 验证按Win R输入cmd回车打开黑色命令行窗口依次输入python --version conda --version看到两行版本号例如Python 3.12.x和conda 24.x.x第一步完成。Mac 用户.pkg双击安装一路下一步即可装完在终端里执行python3 --version验证。后文命令行示例中Mac 把python写作python3。3.4 第二步安装 VS CodeWindows / Mac 通用官网code.visualstudio.com下载安装。Windows 安装向导里的勾选项全部勾上尤其添加到 PATH和两个通过 Code 打开右键菜单打开 VS Code点左侧边栏四个方块的扩展图标搜索Python安装发布者为 Microsoft的官方扩展下载量千万级那个顺手搜Chinese安装中文语言包界面变中文。3.5 第三步让 VS Code 接上 Anaconda关键一步装完两个软件还差最后一步接线——告诉 VS Code 用哪个解释器在桌面新建文件夹python学习用 VS Code 打开文件 → 打开文件夹在里面新建 txt 文件重命名为验证环境.py然后把本文配套代码粘贴进去保存即可本文配套代码复制进去保存把下面代码保存为验证环境.pyimportsysimportplatformimportimportlib.utilprint(*40)print(环境体检报告)print(*40)print(fPython 版本{sys.version.split()[0]})print(f解释器位置{sys.executable})print(f操作系统{platform.system()}{platform.release()})print(fCPU 架构{platform.machine()})ifsys.version_info(3,10):print(结论版本满足本专栏要求3.10可以开始第 2 篇)else:print(结论版本低于 3.10请按第 01 篇重装最新版 Anaconda)forlibin(pandas,openpyxl):okimportlib.util.find_spec(lib)isnotNoneprint(f工具库{lib}{已就绪ifokelse未安装用到时再装不影响入门})4. 按Ctrl Shift PMacCmd Shift P输入Python: Select Interpreter回车5. 在弹出的解释器列表里选路径里带anaconda3的那一项6. 回到代码文件点右上角的运行小三角或按Ctrl F5。下方终端第一次可能提示选择终端类型选默认即可。看到终端打印出环境体检报告环境搭建完成。逐行说明三个要点sys.version/sys.executable当前在跑你代码的这个 Python 的版本和安装位置。当电脑里有多个 Python 时这两行是辨别现在用的到底是谁的唯一可靠办法find_spec检查某个库装没装不用真的加载它速度快f...格式化字符串第 4 篇会正式讲这里照抄即可。四、运行效果正常输出类似 环境体检报告 Python 版本3.7.0 解释器位置D:\Anaconda3\python.exe 操作系统Windows 10 CPU 架构AMD64 结论版本低于 3.10请按第 01 篇重装最新版 Anaconda 工具库 pandas已就绪 工具库 openpyxl已就绪重点核对两处解释器位置里是否含anaconda3结论行是否为可以开始第 2 篇。任何一处不对直接跳到下一节对症排查。五、常见报错与排查本篇精华建议收藏报错 1python 不是内部或外部命令也不是可运行的程序C:\Users\xxxpython --version python 不是内部或外部命令也不是可运行的程序或批处理文件。原因安装时没勾 Add to PATH系统找不到解释器。解决二选一开始菜单搜Anaconda Prompt打开它是 Anaconda 自带的命令行永远认识 python以后练习就用它重装一遍 Anaconda在 Advanced Options 界面勾上 PATH3.5 节配图 5。报错 2输入 python 弹出 Microsoft Store微软商店原因Windows 自带两个假 python 别名把命令拦截了。解决设置 → 应用 → 高级应用设置 →应用执行别名把python.exe和python3.exe两个开关关掉重开命令行再试。报错 3conda不是内部或外部命令但 python 能用原因PATH 只配置了一半。解决先用 Anaconda Prompt 顶着有空时重装并勾选 PATH 一劳永逸。报错 4pip install xxx卡很久最后报超时WARNING: Retrying (Retry(total4, ...)) after connection broken by ReadTimeoutError原因pip 默认从国外服务器下载国内网络慢。解决换清华镜像命令行执行一次、永久生效pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple报错 5电脑里早就装过别的 PythonVS Code 运行报找不到库或行为不对典型受害者装过其他软件自带的 Python某些工具、旧教程。原因VS Code 选中的解释器不是 Anaconda 那个。解决Ctrl Shift P→Python: Select Interpreter→ 选路径带anaconda3的那项拿不准时运行验证环境.py看解释器位置一行的路径即可确认。排查心法对应 3.1 节的三者关系命令行报不是内部或外部命令命令行找不到执行者VS Code 行为诡异稿纸接错了执行者pip 报超时商店网络问题。先定位是哪一环再对号入座。六、练习作业在命令行分别执行python --version和conda --version确认都能出版本号运行验证环境.py把你的环境体检报告贴在评论区看不到报告的同学报错信息也贴上来我会逐条回复——这也是第 2 篇开头的举手签到选做为模块三预热执行pip install requests再用pip show requests确认安装成功。下一篇预告《02 你的第一行代码让电脑听你的》——print 的玩法、运行脚本的三种方式、以及新手第一次看到红色报错时该怎么办。
01 搭建环境：10 分钟装好 Anaconda + VS Code（图文详解 + 5 个高频报错排查）
一、场景引入先建厨房再学做菜写 Python 代码之前得先把两样东西装好解释器和编辑器。很多新手在这第一步就被劝退装了编辑器却运行不了代码、命令行里敲python没反应、或者莫名弹出微软商店。这一篇就是来解决它们的——按顺序做10 分钟内你会得到一个能运行 Python 的解释器Anaconda自带后文要用的常用库一个好用的代码编辑器VS Code一份环境体检报告脚本随时确认环境是否正常。二、本篇目标装好 Anaconda含 Python 解释器 常用库装好 VS Code含 Python 扩展运行本篇配套的验证环境.py看到体检报告显示可以开始第 2 篇。不需要写任何代码只需要点鼠标和复制粘贴。三、知识点讲解3.1 解释器和编辑器是什么关系一次讲清后面不再迷糊用一个比喻编辑器VS Code稿纸。让你写得舒服有代码高亮、自动缩进、拼写提示。它自己不会运行代码。**解释器Python**执行者。负责把你写的每一行代码翻译成电脑的动作。我们真正学 Python学的是怎么给这位执行者下指令。pip / conda应用商店。以后要处理 Excel、发邮件就去商店装对应的工具库。三者关系一句话你在稿纸VS Code上写代码稿纸把文件递给执行者Python去跑跑的过程中缺什么工具就通过商店pip去装。新手 90% 的环境问题本质都是这三者没接上线稿纸找不到执行者没选解释器、命令行找不到执行者没加 PATH、执行者找错了人电脑里有多个 Python。记住这句话后面排查报错会反复用到。3.2 为什么选 Anaconda而不是官网直装 PythonAnaconda 是一个Python 大礼包解释器 几百个常用库 环境管理工具一次装齐。对学本专栏的三个好处后面办公自动化要用的 pandas、openpyxl、matplotlib 等Anaconda自带不用一篇篇手动装以后项目多了比如爬虫一套环境、AI 一套环境它自带的环境管理能互不打架安装器会顺手配置好大部分东西新手第一次成功率最高。代价安装包约 1GB占 3~4GB 磁盘。老电脑或 C 盘紧张的同学可以用Miniconda同一家的精简版只有裸解释器几十 MB库用到再装本篇步骤完全通用。说明框python.org 官网直装也完全可以更轻量。但需要自己手动勾选 PATH、再逐个 pip 安装库第一次装最容易翻车。本专栏统一用 Anaconda 讲解已在用官网版 Python 的同学也不用重装——版本满足 3.10 即可继续跟。版本说明Anaconda 每年更新多次近期版本内置 Python 3.11~3.13。不用纠结具体小版本号本专栏任何 Python 3.10 及以上都适用。3.3 第一步安装 AnacondaWindows1. 下载官网www.anaconda.com/download需要填邮箱且国内访问慢。推荐直接用清华镜像速度拉满打开https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/点击 File Name 后的 ↓ 倒序显示找文件名形如Anaconda3-5.3.1-Windows-x86_64.exe的最新版认准Windows-x86_64.exe结尾Mac 用户选MacOS-x86_64.pkgIntel 芯片或MacOS-arm64.pkgM 系列芯片。2. 安装重点看勾选项双击安装包Select Installation Type选Just Me不需要管理员权限最省事Choose Install Location默认路径即可。唯一要求路径里不要有中文和空格默认C:\Users\你的用户名\anaconda3符合要求Advanced Options勾选Add Anaconda3 to my PATH environment variable。这一步最重要——勾了它以后在任何命令行里输入python都能直接用。官方提示不推荐是担心和电脑里已有的其他 Python 冲突对新手来说利大于弊放心勾。第二个选项 Clear the package cache 保持默认即可。等待安装完成装完点掉两个 Finish 页的了解 Anaconda选项即可3. 验证按Win R输入cmd回车打开黑色命令行窗口依次输入python --version conda --version看到两行版本号例如Python 3.12.x和conda 24.x.x第一步完成。Mac 用户.pkg双击安装一路下一步即可装完在终端里执行python3 --version验证。后文命令行示例中Mac 把python写作python3。3.4 第二步安装 VS CodeWindows / Mac 通用官网code.visualstudio.com下载安装。Windows 安装向导里的勾选项全部勾上尤其添加到 PATH和两个通过 Code 打开右键菜单打开 VS Code点左侧边栏四个方块的扩展图标搜索Python安装发布者为 Microsoft的官方扩展下载量千万级那个顺手搜Chinese安装中文语言包界面变中文。3.5 第三步让 VS Code 接上 Anaconda关键一步装完两个软件还差最后一步接线——告诉 VS Code 用哪个解释器在桌面新建文件夹python学习用 VS Code 打开文件 → 打开文件夹在里面新建 txt 文件重命名为验证环境.py然后把本文配套代码粘贴进去保存即可本文配套代码复制进去保存把下面代码保存为验证环境.pyimportsysimportplatformimportimportlib.utilprint(*40)print(环境体检报告)print(*40)print(fPython 版本{sys.version.split()[0]})print(f解释器位置{sys.executable})print(f操作系统{platform.system()}{platform.release()})print(fCPU 架构{platform.machine()})ifsys.version_info(3,10):print(结论版本满足本专栏要求3.10可以开始第 2 篇)else:print(结论版本低于 3.10请按第 01 篇重装最新版 Anaconda)forlibin(pandas,openpyxl):okimportlib.util.find_spec(lib)isnotNoneprint(f工具库{lib}{已就绪ifokelse未安装用到时再装不影响入门})4. 按Ctrl Shift PMacCmd Shift P输入Python: Select Interpreter回车5. 在弹出的解释器列表里选路径里带anaconda3的那一项6. 回到代码文件点右上角的运行小三角或按Ctrl F5。下方终端第一次可能提示选择终端类型选默认即可。看到终端打印出环境体检报告环境搭建完成。逐行说明三个要点sys.version/sys.executable当前在跑你代码的这个 Python 的版本和安装位置。当电脑里有多个 Python 时这两行是辨别现在用的到底是谁的唯一可靠办法find_spec检查某个库装没装不用真的加载它速度快f...格式化字符串第 4 篇会正式讲这里照抄即可。四、运行效果正常输出类似 环境体检报告 Python 版本3.7.0 解释器位置D:\Anaconda3\python.exe 操作系统Windows 10 CPU 架构AMD64 结论版本低于 3.10请按第 01 篇重装最新版 Anaconda 工具库 pandas已就绪 工具库 openpyxl已就绪重点核对两处解释器位置里是否含anaconda3结论行是否为可以开始第 2 篇。任何一处不对直接跳到下一节对症排查。五、常见报错与排查本篇精华建议收藏报错 1python 不是内部或外部命令也不是可运行的程序C:\Users\xxxpython --version python 不是内部或外部命令也不是可运行的程序或批处理文件。原因安装时没勾 Add to PATH系统找不到解释器。解决二选一开始菜单搜Anaconda Prompt打开它是 Anaconda 自带的命令行永远认识 python以后练习就用它重装一遍 Anaconda在 Advanced Options 界面勾上 PATH3.5 节配图 5。报错 2输入 python 弹出 Microsoft Store微软商店原因Windows 自带两个假 python 别名把命令拦截了。解决设置 → 应用 → 高级应用设置 →应用执行别名把python.exe和python3.exe两个开关关掉重开命令行再试。报错 3conda不是内部或外部命令但 python 能用原因PATH 只配置了一半。解决先用 Anaconda Prompt 顶着有空时重装并勾选 PATH 一劳永逸。报错 4pip install xxx卡很久最后报超时WARNING: Retrying (Retry(total4, ...)) after connection broken by ReadTimeoutError原因pip 默认从国外服务器下载国内网络慢。解决换清华镜像命令行执行一次、永久生效pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple报错 5电脑里早就装过别的 PythonVS Code 运行报找不到库或行为不对典型受害者装过其他软件自带的 Python某些工具、旧教程。原因VS Code 选中的解释器不是 Anaconda 那个。解决Ctrl Shift P→Python: Select Interpreter→ 选路径带anaconda3的那项拿不准时运行验证环境.py看解释器位置一行的路径即可确认。排查心法对应 3.1 节的三者关系命令行报不是内部或外部命令命令行找不到执行者VS Code 行为诡异稿纸接错了执行者pip 报超时商店网络问题。先定位是哪一环再对号入座。六、练习作业在命令行分别执行python --version和conda --version确认都能出版本号运行验证环境.py把你的环境体检报告贴在评论区看不到报告的同学报错信息也贴上来我会逐条回复——这也是第 2 篇开头的举手签到选做为模块三预热执行pip install requests再用pip show requests确认安装成功。下一篇预告《02 你的第一行代码让电脑听你的》——print 的玩法、运行脚本的三种方式、以及新手第一次看到红色报错时该怎么办。