Python语言基础：2_环境搭建

Python3 完整环境搭建超详细教程

前言

1. 我们只装 Python3，Python2 已经彻底淘汰，不要下载；
2. 安装分两大块： ① 下载安装 Python 解释器（运行代码的核心程序） ② 配置环境变量（让电脑任意位置调用 python 命令） ③ 代码编辑器（写代码工具，推荐新手用自带 IDLE / VS Code）
3. 全程所有勾选、按钮全部说明，新手跟着点不会出错

一、Windows 系统安装 Python3（最常用）

第一步：官网下载官方安装包

1. 打开浏览器，输入官网地址：https://www.python.org/downloads/windows/
2. 找到 Stable Releases 稳定版本 推荐版本：Python 3.10 / 3.11（兼容性最好，第三方库无兼容坑） 不建议最新 3.13，部分工具适配不完善
3. 往下滑找到对应系统安装包：
   • 电脑 64 位（现在电脑几乎全是）：下载 Windows installer (64-bit)
   • 老旧 32 位电脑：下载 Windows installer (32-bit)

第二步：安装关键步骤（重中之重，一步都不能错）

双击下载好的 .exe 安装文件，弹出安装窗口：

必勾选项（窗口最下方）

✅ Add python.exe to PATH 翻译：把 Python 添加到系统环境变量

新手 90% 报错都是没勾这个！不勾选，cmd 命令行无法识别 python 指令。

两种安装模式

1. Install Now（默认安装，推荐新手） 自动装到 C 盘用户目录，无需手动改路径，最简单
2. Customize installation（自定义安装，想改安装路径选这个）

选择 Install Now 流程（新手首选）

1. 勾选 Add python.exe to PATH → 点击 Install Now
2. 等待进度条走完，出现 Setup was successful = 安装成功
3. 点击 Close 关闭窗口

自定义安装（想装 D 盘 / 其他盘）

1. 勾选 Add python.exe to PATH → 点 Customize installation
2. 全部子选项默认打勾，直接下一步 Next
3. 勾选最下方：Install for all users
4. 点击 Browse 修改安装路径，举例： D:\Python311 路径不要中文、不要空格（禁止 D:\ 软件 \python 这种）
5. 全部勾选下方四个选项，点击 Install 等待完成

第三步：验证是否安装成功（核心校验）

1. 快捷键 Win + R，输入 cmd 回车，打开黑色命令提示符窗口

2. 输入第一条命令，回车：

   python --version

情况 1：成功（正常）

输出：Python 3.11.9（你安装的版本号） 代表解释器 + 环境变量全部配置完成。

情况 2：报错 'python' 不是内部或外部命令

原因：安装时没勾选 Add python.exe to PATH 解决办法：重新运行安装包，选择 Modify 修改安装，补上勾选重新安装。

1. 再测试 pip 工具（Python 包管理器，以后装爬虫、AI 库全靠它） 输入：

   pip --version

出现版本路径即正常。

第四步：简单测试一段 Python 代码（验证运行）

cmd 窗口输入 python 回车，进入 Python 交互式环境（出现 >>> 符号） 输入代码：

print("我的Python环境搭建成功啦！")

回车，控制台打印文字代表可以正常运行。 输入 exit() 退出交互窗口。

第五步：自带编辑器 IDLE（新手临时写代码，无需额外安装）

1. 左下角开始菜单搜索 IDLE 打开

2. 新建文件：顶部栏 File → New File

3. 粘贴代码：

   name = input("请输入你的名字：")
   print(f"你好，{name}！")

4. 保存：Ctrl+S，文件名必须以 .py 结尾，例如 test.py

5. 运行代码：F5 快捷键，底部弹出运行窗口。

二、Mac OS 苹果电脑安装 Python3

Mac 自带 Python2，系统不自带 Python3，必须手动安装两种方式：

方式 1：官网安装包（零基础推荐）

1. 官网下载对应 macOS 安装包：https://www.python.org/downloads/macos/

2. 下载后缀 .pkg 文件，双击一路继续安装

3. 安装完成后打开「终端」（启动台搜索 终端）

4. 输入验证命令：

   python3 --version

Mac 区分 python/python3，python 默认是 2 代，所有命令必须写 python3 /pip3

方式 2：Homebrew 安装（有基础再用）

1. 终端输入 brew 安装脚本（官网复制）
2. 执行安装 python3：brew install python3
3. 验证同上 python3 --version

Mac 测试代码

终端输入 python3 进入交互环境：

print("Mac Python3 运行正常")

三、通用代码编辑器 VS Code 安装（写代码主力工具，强烈推荐）

IDLE 只能简单练习，长期写代码用 VS Code，免费轻量。

1. 下载 VS Code

官网：https://code.visualstudio.com/ 下载对应系统版本安装

2. 安装 Python 插件（必须装）

1. 打开 VS Code，左侧扩展图标（四个方块）
2. 搜索框输入 Python，微软官方发布的插件，点击安装
3. 安装完成后重启 VS Code

3. VS Code 使用流程演示

1. 左上角 文件 → 新建文件，保存为 demo.py

2. 写入测试代码：

   求和小程序

   a = int(input("请输入数字1："))
   b = int(input("请输入数字2："))
   print("两数相加结果：", a + b)

3. 右键空白处 → 在终端中运行 Python 文件

4. 底部终端输入数字，程序正常运行即配置完成。

四、pip 包管理器使用（环境必备工具，新手必学）

pip 是 Python 自带工具，用来下载第三方库（爬虫、数据分析、AI 工具）

Windows 命令

# 查看pip版本
pip --version
# 更新pip自身
pip install --upgrade pip
# 安装第三方库举例：安装爬虫库requests
pip install requests

Mac 命令（加 3）

pip3 install requests

举例实操

安装办公自动化库 openpyxl（操作 Excel） Windows cmd 输入：

pip install openpyxl

出现 Successfully installed 代表安装成功。

五、新手常见报错 + 完整解决方案

报错 1：'python' 不是内部或外部命令

原因：安装时未勾选 Add python.exe to PATH 解决：重新运行安装包 → Modify → Next，勾选添加环境变量，完成安装。

报错 2：pip 安装库提示权限不足

Windows：右键 cmd，选择「以管理员身份运行」再执行 pip 命令

报错 3：代码文件命名为 python.py

禁止！文件名不能和 python 关键字重名，会导致程序冲突，建议 test.py、demo.py

报错 4：运行代码出现中文乱码

在代码最顶部加一行：

# -*- coding: utf-8 -*-
print("中文测试")

报错 5：保存文件名不带 .py

文件只会被识别为文本，无法运行，必须后缀 .py

六、完整搭建流程总结（极简步骤，方便记忆）

Windows

1. 官网下载 Python3.11 64 位安装包
2. 安装勾选 Add python.exe to PATH，一键 Install Now
3. cmd 输入 python --version 验证安装
4. 可选：安装 VS Code + Python 插件，长期写代码使用
5. 使用 pip install 库名安装工具包

Mac

1. 官网下载 pkg 安装包
2. 终端执行 python3 --version 验证
3. 代码运行全部使用 python3 /pip3 指令