2、工欲善其事：Python 3.10+ 与 Flask 框架的安装与验证

说实话，写代码这件事，最怕的就是环境没搭好就开始写。

我见过太多新手，代码写得挺漂亮，结果一运行报错「找不到模块」，然后心态就崩了。嗯，咱们先把地基打牢。

2.1 为什么选 Python 3.10+？

你可能要问：Python 3.8、3.9 不也挺好吗？为什么非要 3.10 以上？

我个人习惯是，能用新版本就用新版本。Python 3.10 带来了几个很实用的特性：

结构模式匹配（match-case）：写路由分发时特别清爽
更清晰的错误提示：报错信息会告诉你「你是不是少了个括号？」
类型联合写法：str | int 比 Union[str, int] 简洁多了

我在项目中遇到过一回，用 Python 3.7 写了个小工具，同事用 3.10 跑直接报语法错误。从那以后，我统一要求团队用 3.10+。

  最低要求：Python 3.10 及以上版本。如果你还在用 3.6 或 3.7，建议立刻升级。

2.2 安装 Python 3.10+

不同系统安装方式略有不同，我分别说一下。

Windows 用户

去 python.org 下载 3.10+ 的安装包
安装时 务必勾选「Add Python to PATH」
一路 Next 就行

macOS 用户

我推荐用 Homebrew 安装，干净利落：

brew install python@3.11

Linux 用户

Ubuntu/Debian 系：

sudo apt update
sudo apt install python3.11 python3.11-venv python3.11-pip

小技巧：装完后在终端输入 python3 --version 确认版本。如果显示的是 3.10+，就对了。

2.3 验证 Python 安装

打开终端（Windows 叫命令提示符或 PowerShell），输入：

python3 --version

你应该看到类似这样的输出：

Python 3.11.4

如果报错说找不到命令，别慌。试试 python --version（不加 3）。

为什么会这样？因为有些系统里 python 指向的是 Python 2，而 python3 才是 Python 3。嗯，历史遗留问题。

2.4 安装 Flask 框架

Flask 是 Python 里最轻量的 Web 框架之一。说白了，它就是一个帮你处理 HTTP 请求的小工具。

我个人习惯用虚拟环境来装 Flask，这样不会污染系统级的 Python 包：

# 创建虚拟环境
python3 -m venv venv

# 激活虚拟环境（Windows）
venv\Scripts\activate

# 激活虚拟环境（macOS/Linux）
source venv/bin/activate

# 安装 Flask
pip install flask

注意：千万不要用 sudo pip install flask！我曾经这么干过，结果把系统 Python 搞乱了，重装了三次系统才恢复。虚拟环境是你的好朋友。

2.5 验证 Flask 安装

装完后，我们来写个最简单的「Hello World」程序，验证一切正常。

新建一个文件 app.py，写入：

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return 'Hello, 世界！'

if __name__ == '__main__':
    app.run(debug=True)

然后在终端运行：

python3 app.py

你会看到类似这样的输出：

 * Running on http://127.0.0.1:5000
 * Restarting with stat

打开浏览器，访问 http://127.0.0.1:5000，如果看到「Hello, 世界！」，恭喜你，环境搭建成功了！

避坑指南：如果浏览器显示「无法访问」，先检查终端有没有报错。最常见的坑是端口被占用，换个端口试试：app.run(debug=True, port=5001)。

2.6 本章知识体系

下面这张图帮你理清今天的内容结构：

2.7 常见问题速查表

问题	原因	解决方法
`python3` 命令找不到	系统未将 Python 加入 PATH	重新安装并勾选「Add to PATH」
`pip install flask` 报错	网络问题或权限不足	使用国内镜像源：`pip install flask -i https://pypi.tuna.tsinghua.edu.cn/simple`
Flask 启动后浏览器无法访问	端口被占用或防火墙拦截	换端口：`app.run(port=5001)`
虚拟环境激活失败	执行策略限制（Windows）	以管理员身份运行 PowerShell，执行 `Set-ExecutionPolicy Unrestricted`

  总结一下：今天咱们搞定了三件事——装 Python、建虚拟环境、装 Flask 并验证。这三步走完，你的开发环境就准备好了。接下来就可以开始写真正的代码了。

可可精品资料库

📚 课程目录

2、工欲善其事：Python 3.10+ 与 Flask 框架的安装与验证

2.1 为什么选 Python 3.10+？

2.2 安装 Python 3.10+

Windows 用户

macOS 用户

Linux 用户

2.3 验证 Python 安装

2.4 安装 Flask 框架

2.5 验证 Flask 安装

2.6 本章知识体系

2.7 常见问题速查表