企业官网建设流程全解析

一、场景引入：先建厨房，再学做菜

写 Python 代码之前，得先把两样东西装好：解释器和编辑器。

很多新手在这第一步就被劝退：装了编辑器却运行不了代码、命令行里敲python没反应、或者莫名弹出微软商店。这一篇就是来解决它们的——按顺序做，10 分钟内你会得到：

• 一个能运行 Python 的解释器（Anaconda，自带后文要用的常用库）；
• 一个好用的代码编辑器（VS Code）；
• 一份"环境体检报告"脚本，随时确认环境是否正常。

二、本篇目标

1. 装好 Anaconda（含 Python 解释器 + 常用库）；
2. 装好 VS Code（含 Python 扩展）；
3. 运行本篇配套的验证环境.py，看到体检报告显示"可以开始第 2 篇"。

不需要写任何代码，只需要点鼠标和复制粘贴。

三、知识点讲解

3.1 解释器和编辑器是什么关系（一次讲清，后面不再迷糊）

用一个比喻：

• 编辑器（VS Code）＝稿纸。让你写得舒服：有代码高亮、自动缩进、拼写提示。它自己不会运行代码。
• **解释器（Python）**＝执行者。负责把你写的每一行代码翻译成电脑的动作。我们真正"学 Python"，学的是怎么给这位执行者下指令。
• pip / conda＝应用商店。以后要处理 Excel、发邮件，就去商店装对应的工具库。

三者关系一句话：你在稿纸（VS Code）上写代码，稿纸把文件递给执行者（Python）去跑，跑的过程中缺什么工具就通过商店（pip）去装。

新手 90% 的环境问题，本质都是这三者没接上线：稿纸找不到执行者（没选解释器）、命令行找不到执行者（没加 PATH）、执行者找错了人（电脑里有多个 Python）。记住这句话，后面排查报错会反复用到。

3.2 为什么选 Anaconda，而不是官网直装 Python

Anaconda 是一个"Python 大礼包"：解释器 + 几百个常用库 + 环境管理工具，一次装齐。

对学本专栏的三个好处：

1. 后面办公自动化要用的 pandas、openpyxl、matplotlib 等，Anaconda自带，不用一篇篇手动装；
2. 以后项目多了（比如爬虫一套环境、AI 一套环境），它自带的环境管理能互不打架；
3. 安装器会顺手配置好大部分东西，新手第一次成功率最高。

代价：安装包约 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 第一步：安装 Anaconda（Windows）

1. 下载

官网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.pkg（Intel 芯片）或MacOS-arm64.pkg（M 系列芯片）。
  

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 Code（Windows / Mac 通用）

1. 官网code.visualstudio.com下载，安装。Windows 安装向导里的勾选项全部勾上（尤其"添加到 PATH"和两个"通过 Code 打开"右键菜单）；
   
   
   
   
   
   
   

2. 打开 VS Code，点左侧边栏四个方块的扩展图标，搜索Python，安装发布者为 Microsoft的官方扩展（下载量千万级那个）
   
   
   顺手搜Chinese安装中文语言包，界面变中文。
   
   
   

3.5 第三步：让 VS Code 接上 Anaconda（关键一步）

装完两个软件，还差最后一步"接线"——告诉 VS Code 用哪个解释器：

1. 在桌面新建文件夹python学习，用 VS Code 打开（文件 → 打开文件夹）；
   
2. 在里面新建 txt 文件重命名为：验证环境.py，然后把本文配套代码粘贴进去保存即可（本文配套代码，复制进去保存）；
   把下面代码保存为验证环境.py：

importsysimportplatformimportimportlib.utilprint("="*40)print("环境体检报告")print("="*40)print(f"Python 版本：{sys.version.split()[0]}")print(f"解释器位置：{sys.executable}")print(f"操作系统：{platform.system()}{platform.release()}")print(f"CPU 架构：{platform.machine()}")ifsys.version_info>=(3,10):print("结论：版本满足本专栏要求（3.10+），可以开始第 2 篇")else:print("结论：版本低于 3.10，请按第 01 篇重装最新版 Anaconda")forlibin("pandas","openpyxl"):ok=importlib.util.find_spec(lib)isnotNoneprint(f"工具库{lib}：{'已就绪'ifokelse'未安装（用到时再装，不影响入门）'}")

4. 按Ctrl + Shift + P（Mac：Cmd + 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 篇"。任何一处不对，直接跳到下一节对症排查。

五、常见报错与排查（本篇精华，建议收藏）

报错 1：'python' 不是内部或外部命令，也不是可运行的程序

C:\Users\xxx>python --version 'python' 不是内部或外部命令，也不是可运行的程序或批处理文件。

原因：安装时没勾 Add to PATH，系统找不到解释器。
解决（二选一）：

• 开始菜单搜Anaconda Prompt打开（它是 Anaconda 自带的命令行，永远认识 python），以后练习就用它；
• 重装一遍 Anaconda，在 Advanced Options 界面勾上 PATH（3.5 节配图 5）。

报错 2：输入 python 弹出 Microsoft Store（微软商店）

原因：Windows 自带两个"假" python 别名把命令拦截了。
解决：设置 → 应用 → 高级应用设置 →应用执行别名，把python.exe和python3.exe两个开关关掉，重开命令行再试。

报错 3：conda不是内部或外部命令，但 python 能用

原因：PATH 只配置了一半。
解决：先用 Anaconda Prompt 顶着；有空时重装并勾选 PATH 一劳永逸。

报错 4：pip install xxx卡很久最后报超时

WARNING: Retrying (Retry(total=4, ...)) after connection broken by 'ReadTimeoutError'

原因：pip 默认从国外服务器下载，国内网络慢。
解决：换清华镜像，命令行执行一次、永久生效：

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

报错 5：电脑里早就装过别的 Python，VS Code 运行报"找不到库"或行为不对

典型受害者：装过其他软件自带的 Python（某些工具、旧教程）。
原因：VS Code 选中的解释器不是 Anaconda 那个。
解决：Ctrl + Shift + P→Python: Select Interpreter→ 选路径带anaconda3的那项；拿不准时，运行验证环境.py看"解释器位置"一行的路径即可确认。

排查心法（对应 3.1 节的三者关系）：
命令行报"不是内部或外部命令"＝命令行找不到执行者；
VS Code 行为诡异＝稿纸接错了执行者；
pip 报超时＝商店网络问题。先定位是哪一环，再对号入座。

六、练习作业

1. 在命令行分别执行python --version和conda --version，确认都能出版本号；
2. 运行验证环境.py，把你的"环境体检报告"贴在评论区（看不到报告的同学，报错信息也贴上来，我会逐条回复）——这也是第 2 篇开头的举手签到；
3. 选做：为模块三预热，执行pip install requests，再用pip show requests确认安装成功。

下一篇预告：《02 你的第一行代码：让电脑听你的》——print 的玩法、运行脚本的三种方式、以及新手第一次看到红色报错时该怎么办。