Python►基础入门

环境搭建：安装 Python 与配置 IDE

上一篇 Python 简介与发展历史 我们讲清楚了 Python 是什么。这一篇要开始动手了。很多人学编程折在了第一步——装环境。装了三小时 Python，还没写一行代码，就已经想放弃了。本文的目标就是把你从这种痛苦里救出来：Windows、macOS、Linux 三平台一次讲清楚，同时给出一个 2025 年主流的 IDE 选型建议。读完你应该能在自己的电脑上顺利执行 python --version 并进入 IDE 敲下第一段代码。

一、选择 Python 版本

打开 https://www.python.org/downloads/ 你会看到很多版本。新手一律选择最新的稳定版（截至 2025 年 9 月，这个版本是 Python 3.13.x）。如果你必须与旧项目兼容，可以选 3.10 或 3.11，本系列教程 100% 兼容 3.10+。

不要装 Python 2。Python 2 已于 2020 年 EOL（停止维护），任何现代教程或项目都不再支持它。

有些教材推荐 Anaconda，那是”Python + 一堆数据科学库”的整体发行版。如果你目标是数据分析/AI，Anaconda 确实方便；但作为通用学习，Anaconda 太重，还常与官方 Python 冲突，本教程推荐使用官方 Python + pip + venv的最小组合。

二、Windows 下安装 Python

步骤 1：下载安装包

去 https://www.python.org/downloads/windows/ 下载 “Windows installer (64-bit)”。

步骤 2：勾选 Add python.exe to PATH

安装向导第一屏底部有一个小勾选框 “Add python.exe to PATH”，必须勾上！这个勾没勾，是新手 90% 环境问题的根源。勾上之后，你在任意目录打开命令行都能直接调用 python。

然后点 “Install Now” 一路默认即可。

步骤 3：验证

按下 Win + R，输入 cmd 回车，在命令行中输入：

1
python --version

如果显示 Python 3.13.x（或你安装的版本号），恭喜，装成功了。

如果出现 “python 不是内部或外部命令”，说明 PATH 没添加。解决方案：卸载 → 重装 → 记得勾选 Add to PATH。或者手动到 “系统属性 → 环境变量 → Path” 里添加 Python 安装目录（例如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python313\）。

Windows 特别提示：py 启动器

Windows 版 Python 自带一个 py 启动器，可以同时管理多个版本：

1
2
3
py -3.10     # 启动 Python 3.10
py -3.13     # 启动 Python 3.13
py           # 启动默认版本

三、macOS 下安装 Python

macOS 自带一个 python3，但版本旧且不能随便升级。推荐两种方式：

方式 1：官网 pkg 安装

去 https://www.python.org/downloads/macos/ 下载 macOS installer，双击 pkg 一路点下一步即可。

方式 2：Homebrew（推荐）

如果你已经安装了 Homebrew（一个 macOS 包管理器）：

1
brew install python@3.13

安装完成后：

1
python3 --version

在 macOS 上通常需要输入 python3 而不是 python（因为系统自带一个 Python 2 时代的 python 命令），这个习惯请记住。

四、Linux 下安装 Python

主流发行版都自带 Python 3，但版本可能不够新。以 Ubuntu 22.04+ 为例：

1
2
3
sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version

如果需要更新的版本，可以用 deadsnakes PPA：

1
2
3
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.13 python3.13-venv

CentOS/RHEL 系用 dnf 或 yum：sudo dnf install python3.13。

五、pip：Python 的包管家

Python 3.4+ 自带 pip，安装完 Python 后直接可用：

1
2
pip --version              # Windows
pip3 --version             # macOS/Linux

pip 是安装第三方库的工具。举个例子，我们后面要用的 requests 库：

1
pip install requests

由于 pip 默认从国外服务器下载，国内用户常常慢到怀疑人生。可以换成清华源：

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

设置一次全局生效。

六、IDE 选型：2025 年的推荐

写 Python 用什么工具？下面按学习阶段给出建议：

1. VS Code（推荐 · 全阶段可用）

  • 免费、跨平台、启动快、插件丰富；
  • 装两个官方插件：Python + Pylance（微软出品，提供强大的类型检查和自动补全）；
  • 内置 Jupyter Notebook 支持，可用于数据分析；
  • 是本教程默认推荐的 IDE。

2. PyCharm（推荐 · 面向工程）

  • JetBrains 出品，功能最全的 Python IDE；
  • Community 版免费够用，Professional 版对 Django/Flask/科学计算支持更强；
  • 内存占用较大，但重构、调试、导航体验极佳；
  • 适合写中大型项目。

3. Jupyter Notebook / JupyterLab

  • 数据分析、机器学习必备；
  • 交互式笔记本，适合边写代码边看结果；
  • 不适合写完整的应用。

4. IDLE（不推荐）

  • Python 自带的最简 IDE；
  • 只适合看官方教程时快速试一段代码；
  • 不建议长期使用。

5. Cursor / Windsurf 等 AI IDE

  • 基于 VS Code 二次开发，内置 AI 补全；
  • 新手不推荐——你会习惯让 AI 帮你写代码，导致基础不扎实；
  • 学完前 30 篇再上手，会真香。

七、配置 VS Code 写第一段 Python

假设你选了 VS Code，我们完整走一遍配置：

步骤 1：安装 VS Code

去 https://code.visualstudio.com/ 下载安装，一路默认。

步骤 2：安装 Python 插件

  • 打开 VS Code → 左侧插件市场（Ctrl+Shift+X）；
  • 搜索 “Python”，安装 Microsoft 出品的那个（Pylance 会一起装上）。

步骤 3：新建项目并写代码

  • 在电脑上任意位置新建一个文件夹 python-learn；
  • VS Code → File → Open Folder → 选中它；
  • 在这个文件夹里新建 hello.py：
1
2
3
4
5
# hello.py
# 我的第一段 Python 代码

name = input("请输入你的名字：")
print(f"你好，{name}！欢迎来到 Python 世界。")

步骤 4：选择 Python 解释器

按 Ctrl+Shift+P 打开命令面板，输入 “Python: Select Interpreter”，选择你刚才装好的 Python 版本。这是 每个 Python 项目都要做的事，否则代码补全和运行会出问题。

步骤 5：运行

  • 方法一：VS Code 右上角有个绿色三角形运行按钮，点它；
  • 方法二：打开集成终端 (`Ctrl+\)，输入 python hello.py。

看到 “请输入你的名字：” 说明一切就绪。

八、创建虚拟环境（建议养成的好习惯）

尽管我们要在第 25 篇 pip 与虚拟环境 venv 中详细讲，但强烈建议从第一天就养成用虚拟环境的习惯。它的意义是：每个项目一个独立的 Python 依赖沙箱，互不干扰。

在项目根目录执行：

1
2
3
4
5
6
7
# Windows
python -m venv .venv
.venv\Scripts\activate

# macOS/Linux
python3 -m venv .venv
source .venv/bin/activate

激活后你会看到命令行前多了 (.venv)，此时用 pip install xxx 装的库只属于这个项目。退出虚拟环境用 deactivate。

在 VS Code 中，Ctrl+Shift+P → “Python: Select Interpreter” 选中 .venv 里的解释器，之后所有终端和运行都会走虚拟环境。

九、常见问题排查

Q1：终端 python 命令能用，但 VS Code 报”未找到 Python”。
A：在 VS Code 里手动指定解释器路径（Select Interpreter → Enter interpreter path）。

Q2：pip install 报 SSL 错误。
A：升级 pip：python -m pip install --upgrade pip；或改用清华/阿里镜像源。

Q3：装了两个 Python 版本，运行的时候搞不清用了哪个。
A：python -c "import sys; print(sys.executable)" 可以打印当前解释器的绝对路径。

Q4：Windows 下运行 python 弹出应用商店。
A：这是 Windows 的”Python 别名快捷方式”。到 “设置 → 应用 → 应用别名”里关掉，或者装好官方 Python 后即可覆盖。

Q5：中文乱码。
A：现代 Python 3 默认 UTF-8，但个别 Windows 终端还用 GBK。可以在文件顶部加上 # -*- coding: utf-8 -*-（其实 3.x 不需要）；或者设置终端编码为 UTF-8：chcp 65001。

十、常见陷阱

  1. 忘记勾选 Add to PATH —— 装完 Python 用不了，是最常见 Windows 陷阱；
  2. 系统里存在多个 Python —— macOS/Linux 有一个系统自带、一个 Homebrew、一个 pyenv，pip install 可能装到”错的那个”，结果代码里 import 失败；
  3. 在系统 Python 里 pip install 一堆库 —— 项目多了就打架，因此建议虚拟环境；
  4. IDE 里没选对解释器 —— 代码补全一片红，其实语法都是对的；
  5. 用 root/sudo 安装 pip 包 —— 权限混乱，久了必炸，永远不要 sudo pip install。

十一、小结与延伸阅读

  • 官方 Python + pip + venv 是最纯净、最不容易出问题的组合；
  • Windows 装完记得勾选 Add to PATH；
  • macOS/Linux 上一般叫 python3，而不是 python；
  • VS Code + Python 插件是新手最佳选择；
  • 从第一天起就用虚拟环境；
  • 遇到问题 90% 是解释器选错或者 PATH 没配好。

延伸阅读：

下一篇 第一个 Python 程序：Hello World 与运行方式 我们会开始真正的编程，教你用几种不同的方式运行 Python 代码。