罗罗编程学习记录
本页内容 展开查看

08.1 阶段 0:环境与工程基础

所属:全栈开发面试题库 / 学习路径 / 08 Python 全栈

本页目录

一、阶段定位

本阶段不写业务代码,只解决三件事:把解释器装对、把请求从浏览器到 Python 服务的链路看清楚、把代码放进 Git 版本管理。后续阶段 1 开始写语言核心,阶段 4 开始写 Web 接口,所有示例都建立在「解释器版本正确、命令入口明确、代码有版本记录」这三个前提上。

与前后阶段的衔接:因为本阶段只做到「脚本能在命令行跑通」,阶段 1 就要在这个可运行的环境里练习对象模型、函数与异常,环境一旦混乱(多版本互相覆盖、依赖装到全局),后面所有示例都会变成「在我这跑是好的」。本阶段把 WSGI 与 ASGI 的区别讲清楚,是为了阶段 4 选择 uvicorn 还是 gunicorn、阶段 6 讨论事件循环时不再回头补概念。

原有卡点及判断依据:

  • 不同项目混用全局 Python 环境导致依赖冲突:判断现象是 pip install requests 装完后,另一个项目 import 时版本不对;或 pip list 里能看到几十个互不相关的包。修法不是删包,而是每个项目一个虚拟环境(见 5.3)。
  • 分不清 CLI 脚本与 Web 服务各自监听的入口:判断现象是改完 .py 文件后直接双击运行,与命令行 python app.py 行为不一致;或不知道进程监听在哪个端口。本阶段 5.2 与 5.5 会把两种入口讲清楚。
  • 把「脚本能跑」误当成「Web 下也能跑通」:判断现象是脚本里用了相对路径读文件,命令行执行正常,但被 uvicorn 启动后报 FileNotFoundError。原因是工作目录(cwd)不同,见 5.2 与排障表。

二、阶段目标与投入

学完本页,应当能用可观察的行为证明以下六条能力,而不是「看过教程」:

能力目标(可验证的行为) 验证方式
能在本机确认 Python 版本在 3.11 及以上,并能区分 python 与 python3 指向哪个解释器 python -c "import sys; print(sys.executable, sys.version)" 输出明确
能写出带命令行参数的脚本,用 argparse 接收 --top N 并统计 CSV 脚本在任意目录用完整路径调用都能跑,不依赖 cwd
能为一个项目创建独立虚拟环境,安装依赖并确认它与全局环境隔离 激活后 pip list 只含项目自己的包
能用 curl -i 发起请求并读明白状态码、响应头与响应体 对任意公网测试接口完成一次 GET 与一次 POST
能说清 WSGI 与 ASGI 的差别,并写出一个最小 WSGI 应用与一个最小 ASGI 应用 两个应用都能在本地用对应服务器跑起来并返回 200
能用 Git 提交代码,且 .gitignore 正确排除了 .venv/ 与 __pycache__/ git status 干净;克隆到另一目录后 python -m venv .venv && pip install -r requirements.txt 能复现

建议学时:

  • 全职(每天有效学习 4–6 小时):1 周,约 30 小时。其中环境与命令行 8 小时、HTTP 与 Nginx 10 小时、Git 与 WSGI/ASGI 12 小时。
  • 在职(每天 2 小时、周末补 4 小时):2 周,约 28 小时。

学时分配建议:解释器与虚拟环境 20%、CLI 脚本 15%、HTTP 与状态码 20%、WSGI/ASGI 20%、Git 15%、Nginx 反代 10%。Nginx 是首次接触即可,细节留给阶段 7。

三、先修自检

进入本阶段前,逐条自检;任何一条做不到,先花半天补齐,否则后面的命令示例会无法复现。

先修项 合格标准 不合格时回到
操作系统基本操作 能在终端里切换目录、列文件、看文件内容 补 Linux 命令基础,对照 01.1 操作系统
文本编辑器 能用 VS Code 或任意编辑器新建、保存 .py 文件 先装一个编辑器,不要求熟练快捷键
网络与浏览器 能打开一个网址,知道浏览器地址栏里的内容就是 URL 无需补
Git 是否安装 git --version 能输出版本号 安装 Git 后再来

四、知识地图

「掌握程度」分三档:了解(知道有这个东西)、会用(能写对、能调通)、能讲清原理(能解释底层行为、能回答追问)。

模块 知识点 掌握程度 对应题库章节
解释器 Python 安装、多版本并存、sys.executable 会用 01.1 操作系统
CLI 运行 python script.py、argparse、__name__ == "__main__"、cwd 概念 会用 01.1 操作系统
虚拟环境 venv 创建、激活、site-packages 隔离 会用 01.1 操作系统
HTTP 请求方法、状态码、请求头/响应头、curl 会用 01.1 操作系统
服务接口 WSGI(同步)与 ASGI(异步)的差别 能讲清原理 04.7 Python
Git init/add/commit、.gitignore、克隆与复现 会用 01.1 操作系统
Nginx 反向代理基本配置、proxy_pass 了解 01.1 操作系统

进度管理建议:把这张表复制到自己的笔记里,每做完一个模块把掌握程度往下调一档。《知识点全清单》里环境与命令行相关行是本阶段的全量打勾表。

五、分模块精讲

5.1 Python 解释器安装与多版本管理

为什么需要它:操作系统自带的 Python 要么版本太旧,要么指向应用商店占位符;不同项目要求 3.10、3.11、3.12 不同版本。版本不对,后面的类型注解、match 语句、异常组语法会直接报 SyntaxError。

核心机制:

  • CPython 是 Python 默认实现,python 命令背后真正调用的是一个已安装好的解释器二进制。
  • 一台机器可以同时装多个版本,它们是不同目录下的不同二进制;命令行里 python 指向哪个,取决于 PATH 顺序与安装器是否写入了「Add python.exe to PATH」。
  • Windows 上官方安装后自带 py launcher,用 py -3.11、py -3.12 指定版本;macOS/Linux 上通常 python3 指向系统自带版本,项目版本用 pyenv 或 uv 管理(细节在阶段 3)。
  • 本路径统一以 3.11 为最低基线;3.12、3.13 继续兼容。

最小可运行示例:

# 确认当前调用的是哪个解释器、版本是多少
python --version
python -c "import sys; print(sys.executable)"
# Windows 下用 py launcher 指定版本
py -3.11 --version
# 看 PATH 里 python 解析到哪
where python          # Windows
which python3         # macOS / Linux
# check_env.py:在脚本里显式校验版本,避免别人拿老版本运行
import sys

if sys.version_info < (3, 11):
    raise SystemExit("需要 Python 3.11 及以上,当前为 " + sys.version.split()[0])
print("解释器 OK:", sys.executable)

常见坑:

现象 原因 修法
输入 python 弹出 Microsoft Store Windows 应用执行别名未关闭 关闭「应用执行别名」中的 python 占位项,或改用 py
python --version 是 3.8 但项目要求 3.11 PATH 顺序问题 用 py -3.11 或在虚拟环境内固定版本(阶段 3)
pip install 报 No module named pip 该解释器没有 pip 用 python -m ensurepip 修复

面试考法:常见问法是「Python 解释器和 Python 语言是什么关系」。要答到「CPython 是把源码编译成字节码再由虚拟机执行的实现;python 命令指向的是具体某个实现的某个版本,不是语言本身」。追问会到「同一台机器怎么并存多个版本」,答 launcher 与 PATH 优先级即可。

5.2 CLI 脚本:从 hello.py 到 argparse

为什么需要它:后端服务的入口不是「双击运行」,而是命令行启动。搞清楚 python app.py 背后发生了什么、工作目录是什么,才能避免「脚本里读相对路径文件在命令行正常、在服务里报错」。

核心机制:

  • python script.py 会把当前工作目录(cwd)加入 sys.path,所以脚本里 open("data.csv") 读的是「启动命令时所在目录下的 data.csv」,不是「脚本文件所在目录」下的 data.csv。
  • if __name__ == "__main__": 保证脚本被 import 时不会自动执行主流程,这是 CLI 脚本与可复用模块共用一个文件的标准写法。
  • argparse 是标准库命令行参数解析器,定义 add_argument,parse_args() 返回带属性的对象。
  • 脚本顶部 shebang(#!/usr/bin/env python3)只在类 Unix 系统上让 ./script.py 可直接执行,Windows 无效。

最小可运行示例:

# csv_top.py:统计 CSV 文件行数,并按列输出前 N 行
import argparse
import csv
from pathlib import Path


def count_rows(path: Path) -> int:
    with path.open("r", encoding="utf-8", newline="") as f:
        return sum(1 for _ in csv.reader(f))


def main() -> None:
    parser = argparse.ArgumentParser(description="统计 CSV 行数")
    # 用 Path 对象接收路径,避免手写字符串拼接
    parser.add_argument("file", type=Path, help="CSV 文件路径")
    parser.add_argument("--top", type=int, default=5, help="打印前 N 行")
    args = parser.parse_args()

    print(f"总行数:{count_rows(args.file)}")


if __name__ == "__main__":
    main()
# 在任意目录调用,路径用相对或绝对均可
python csv_top.py ./sales.csv --top 10
# 关键观察:把 data.csv 放到别处,脚本里用相对路径会报错
python csv_top.py data.csv      # 此时 cwd 下没有 data.csv 就 FileNotFoundError

常见坑:

现象 原因 修法
FileNotFoundError: data.csv 启动时 cwd 与脚本所在目录不同 路径用 Path(__file__).parent / "data.csv" 相对脚本定位
import 自己的模块失败 脚本所在目录不在 sys.path 用 python -m 以模块方式启动,或调整工程结构
参数解析报错信息不友好 没定义 description 与 help 给每个 add_argument 补 help 文本

面试考法:常问「脚本里的相对路径为什么在服务里会出错」。要答到「cwd 是启动进程时的目录,不是脚本所在目录;服务用 systemd 或容器启动时 cwd 通常是 /,读文件必须用绝对路径或相对脚本文件定位」。

5.3 虚拟环境与依赖隔离

为什么需要它:直接 pip install requests 会装到全局解释器,项目 A 要 requests 2.28、项目 B 要 2.31,互相覆盖。本阶段只做概念,完整锁文件在阶段 3。

核心机制:

  • python -m venv .venv 会在当前目录建一个 .venv/ 目录,里面是一份指向原解释器的软链(Windows 是拷贝)和一个独立的 site-packages/。
  • 激活脚本本质是改 PATH,把 .venv/Scripts(Windows)或 .venv/bin(macOS/Linux)放到最前,之后 python、pip 都指向这个环境。
  • 全局环境保持干净,项目依赖全部进 .venv/;.venv/ 必须写进 .gitignore,不能提交。

最小可运行示例:

# 创建并激活虚拟环境
python -m venv .venv
# Windows PowerShell
.venv\Scripts\Activate.ps1
# macOS / Linux
source .venv/bin/activate

# 激活后确认 pip 指向环境内
python -c "import sys; print(sys.prefix)"    # 输出项目下的 .venv 路径
pip install requests
pip list
# 退出环境
deactivate
# .gitignore 关键条目
.venv/
__pycache__/
*.pyc

常见坑:

现象 原因 修法
激活了但 pip list 还是全局包 激活脚本没生效,或用了另一个终端 看命令行提示符前是否有 (.venv);用 where python 确认
.venv 被提交进 Git .gitignore 没写 补忽略规则并 git rm -r --cached .venv
换机器后依赖装不上 没有导出依赖清单 pip freeze > requirements.txt 提交,新机器 pip install -r requirements.txt

面试考法:「为什么每个项目都要虚拟环境,直接装全局不行吗」。要答到「隔离依赖版本、避免污染系统 Python、便于卸载(删目录即清理)、便于在干净环境复现」。

5.4 HTTP 请求生命周期与状态码

为什么需要它:写 Web 接口之前,必须先看懂请求/响应长什么样。状态码记不住,后面定位 502、404、405 就没有抓手。

核心机制:

  • 请求行:方法 URL 协议版本;方法:GET(读)、POST(创建)、PUT(整体更新)、PATCH(局部更新)、DELETE(删除)。
  • 状态码分五段:2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误。
  • 常见必背:200 OK、201 Created、301 Moved Permanently、302 Found、400 Bad Request、401 Unauthorized、403 Forbidden、404 Not Found、405 Method Not Allowed、500 Internal Server Error、502 Bad Gateway、503 Service Unavailable。
  • 请求头与响应头是键值对,Content-Type 决定 body 怎么解析。

最小可运行示例:

# -i 显示响应头,-v 显示完整交互过程
curl -i https://httpbin.org/get
curl -X POST -H "Content-Type: application/json" -d '{"name":"ann"}' https://httpbin.org/post
# 看状态码本身
curl -o /dev/null -s -w "%{http_code}\n" https://httpbin.org/status/404

常见坑:

现象 原因 修法
405 Method Not Allowed 路径存在但方法不对,如 POST 到只读路由 检查路由方法声明,而不是改 URL
301 后 POST 变 GET 浏览器缓存了 301 用 307/308 保留方法,或清缓存
502 Bad Gateway Nginx 能连,但后端服务没起 看后端进程是否监听、端口是否一致

面试考法:「GET 和 POST 的区别」是送分题,但要答到「GET 语义是安全且幂等、可被缓存、参数在 URL;POST 语义是创建、不可幂等、参数在 body」。追问常给一段 Nginx 日志问「502 怎么排查」。

5.5 WSGI 与 ASGI:两种服务接口

为什么需要它:Python Web 框架不是自己监听端口,而是实现一个被服务器调用的入口函数。搞清楚 WSGI(同步)与 ASGI(异步),后面选 uvicorn 还是 gunicorn、为什么 FastAPI 不能用 gunicorn 直接跑,才有概念基础。

核心机制:

  • WSGI(PEP 3333):同步协议,一个请求对应一次函数调用,签名是 environ(字典)+ start_response(回调)。Flask、Django 是 WSGI 应用,服务器是 gunicorn/uWSGI。
  • ASGI:异步协议,签名是 scope(连接信息)+ receive(收消息)+ send(发消息),支持协程、WebSocket、长连接、SSE。FastAPI 是 ASGI 应用,服务器是 uvicorn。
  • 一个应用同时只能跑在一种协议下;WSGI 应用不能直接用 uvicorn 跑,ASGI 应用也不能直接用 gunicorn 跑(除非用 worker 类型桥接)。

最小可运行示例:

# wsgi_app.py:最小 WSGI 应用,用 python -m wsgiref.simple_server 跑
def application(environ, start_response):
    start_response("200 OK", [("Content-Type", "text/plain; charset=utf-8")])
    return ["你好,WSGI".encode("utf-8")]
# asgi_app.py:最小 ASGI 应用,用 uvicorn 跑
async def application(scope, receive, send):
    await send({
        "type": "http.response.start",
        "status": 200,
        "headers": [[b"content-type", b"text/plain; charset=utf-8"]],
    })
    await send({"type": "http.response.body", "body": "你好,ASGI".encode("utf-8")})
# 跑 WSGI
python -m wsgiref.simple_server wsgi_app:application
# 跑 ASGI
pip install uvicorn
uvicorn asgi_app:application --port 8000

常见坑:

现象 原因 修法
uvicorn 启动报 The starlette.debug extension has been removed 老版本 starlette 与新 uvicorn 不兼容 升级依赖到兼容版本
gunicorn 直接跑 FastAPI 不出并发 gunicorn 默认 sync worker 跑不了 ASGI 用 gunicorn -k uvicorn.workers.UvicornWorker
WSGI 应用里写 async def WSGI 是同步协议 换成 ASGI 服务器,或把异步逻辑移到任务队列

面试考法:高频题「WSGI 和 ASGI 的区别」。标准答法:「WSGI 一请求一线程一函数,同步阻塞,不支持 WebSocket;ASGI 是异步协议,支持协程并发、WebSocket、SSE、长连接;FastAPI、Starlette、Sanic 走 ASGI,Flask、Django 原生走 WSGI」。

5.6 Git 基本流程

为什么需要它:代码没有版本记录,删错了找不回、出问题不能回滚、协作时不知道改了什么。本阶段只要求单人提交,分支策略留给阶段 7。

核心机制:

  • 三个状态:工作区、暂存区(git add)、提交(git commit)。
  • .gitignore 决定哪些文件不进版本管理;.venv/、__pycache__/、.env 必须忽略。
  • 克隆别人的仓库后,依赖不跟着代码走,必须自己建虚拟环境并安装依赖清单。

最小可运行示例:

git init
echo ".venv/" > .gitignore
git add .
git commit -m "init: 第一个 CLI 脚本"
git log --oneline
# 远程仓库
git remote add origin <仓库地址>
git push -u origin main
# 克隆到新机器后复现环境
git clone <仓库地址> myproj
cd myproj
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

常见坑:

现象 原因 修法
提交后发现 .env 里有密钥 没把 .env 加进 .gitignore 立刻轮换密钥,从历史中清除;把 .env 加入忽略
克隆后 pip install -r requirements.txt 缺包 依赖清单没提交 提交 requirements.txt,不要提交 .venv/
git push 报认证失败 远程地址或凭据不对 改用 SSH 或配置凭据管理器

面试考法:常问「.gitignore 里为什么要忽略 .venv/」。答「虚拟环境与机器、解释器版本绑定,不可跨平台复用;依赖应该通过清单文件复现,而不是直接拷贝环境目录」。

5.7 Nginx 反向代理入门

为什么需要它:线上服务不会直接暴露 8000 端口,前面一定有 Nginx 负责 TLS、多站点路由、静态资源转发。本阶段只要能看懂配置并发起一次代理请求即可。

核心机制:

  • listen 80; server_name example.com; 定义站点。
  • location /api/ { proxy_pass http://127.0.0.1:8000/; } 把路径转发给后端。
  • 关键细节:proxy_pass 末尾带不带斜杠,决定 location 部分是否被替换。
  • 后端真实 IP 由 X-Forwarded-For 头传递,后端服务要读这个头而不是 remote_addr。

最小可运行示例:

server {
    listen 80;
    server_name localhost;

    location /api/ {
        proxy_pass http://127.0.0.1:8000/;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
# 先启动后端(任意目录),再 curl 经过 Nginx
curl http://127.0.0.1:8000/health      # 直接访问后端
curl http://127.0.0.1/api/health       # 经过 Nginx 代理

常见坑:

现象 原因 修法
location /api/ 转发后路径多了一层 proxy_pass 末尾斜杠语义 去掉末尾斜杠或调整 location 写法
后端永远看到 Nginx 的 IP 没传 X-Forwarded-For 加 proxy_set_header X-Forwarded-For
长连接接口被 Nginx 504 断开 proxy_read_timeout 默认 60s 调大该值,流式响应细节在阶段 7

面试考法:「Nginx 在 Python 服务前起什么作用」。答「反向代理、TLS 终结、多服务按路径分发、静态资源直接服务、限流与超时控制、隐藏后端真实端口」。

六、分层练习

三档练习逐档升级,上一档没做完不要跳。

6.1 复现型(照着做,目标是「跑通 + 能解释」)

练习 要求 验收标准 预计耗时
版本自检 写一个脚本打印 sys.executable 与版本 在两个不同终端里运行,输出一致 0.5 小时
CLI 脚本 用 argparse 写 CSV 行数统计,支持 --top N 对样例 CSV 输出正确行数 1 小时
虚拟环境 为该项目建 .venv,安装 requests,写一段 GET 请求 激活与未激活状态下 pip list 明显不同 1 小时
最小 WSGI 应用 手写一个返回 hello 的 WSGI 应用并用 wsgiref 跑起来 curl -i 返回 200 与正确 body 1 小时
最小 ASGI 应用 手写一个 ASGI 应用用 uvicorn 跑起来 curl -i 返回 200 1 小时

6.2 改造型(给出现成代码,改出正确行为)

练习 要求 验收标准 预计耗时
修相对路径 给定一个用 open("data.csv") 的脚本,改成任意 cwd 都能跑 在别的目录调用也能读到正确文件 0.5 小时
补 .gitignore 给定一个未忽略 .venv/ 的仓库,修复并清掉已跟踪文件 git status 干净,克隆后能复现 0.5 小时
状态码复现 用 curl 对 httpbin 发起 404、500 模拟请求 能说出每个状态码的含义 0.5 小时
反向代理 给 Nginx 配一个 /api/ 转发到本地 ASGI 应用 经过 Nginx 访问返回 200 1.5 小时

6.3 设计型(自己定方案,目标是「能交付、能讲清取舍」)

练习 要求 验收标准 预计耗时
环境搭建文档 为一个新项目写 README,从安装到跑起来 另一个人按文档在干净机器上复现成功 2 小时
多版本并存验证 同一台机器装 3.11 与 3.12,分别建虚拟环境 两个环境的 python --version 不同且互不污染 2 小时
请求链路笔记 用 curl 抓一次完整请求,画出从浏览器到 WSGI 应用的步骤 能标注每一步经过的组件 1.5 小时

七、排障表

现象 可能原因 排查步骤 解决办法
python 弹出 Microsoft Store 应用执行别名未关闭 看 where python 指向 关闭别名或用 py
SyntaxError 在 match 语句 解释器版本低于 3.10 python --version 确认 升级解释器或用 if/elif
FileNotFoundError 读文件失败 cwd 与脚本目录不一致 打印 os.getcwd() 用 Path(__file__).parent 定位
pip 装包到全局 虚拟环境没激活 看提示符是否有 (.venv) 重新激活后再装
curl 返回 502 后端进程没起或端口错 netstat -ano | findstr :8000 看监听 启动后端服务
ModuleNotFoundError: No module named 'requests' 包没装在当前环境 在当前环境 pip list 在当前环境 pip install requests
Nginx 访问 404 但后端 200 location 路径与 proxy_pass 拼接错误 看 Nginx 访问日志里的 upstream URL 调整 proxy_pass 末尾斜杠
git push 报权限拒绝 凭据不对或仓库无写权限 看远程地址是 HTTPS 还是 SSH 配置凭据或改用 SSH

八、出口条件

全部勾选后再进入 08.2 阶段 1:语言核心。

  • [ ] python --version 输出 3.11 及以上,sys.executable 指向预期解释器
  • [ ] 每个项目都有独立 .venv/,全局环境保持干净
  • [ ] 能用 argparse 写一个带参数的 CLI 脚本,在任意目录可运行
  • [ ] 能用 curl 读明白状态码、请求头、响应体
  • [ ] 能写出最小 WSGI 与 ASGI 应用,并说清二者差别
  • [ ] Git 仓库里 .gitignore 正确排除 .venv/、__pycache__/、.env
  • [ ] 能说清一个请求经过 Nginx 到 Python 服务的完整链路

自测题(先自己想,再看要点):

  1. 为什么 python app.py 里的相对路径在服务模式下会失效?
    • 要点:cwd 是启动进程时的目录,不是脚本所在目录;服务启动时 cwd 通常是 / 或 systemd 工作目录。
  2. WSGI 和 ASGI 的核心差别是什么?FastAPI 为什么不能用 gunicorn 默认 sync worker 跑?
    • 要点:WSGI 同步一请求一函数;ASGI 异步支持协程。gunicorn 默认 worker 是同步的,必须用 uvicorn.workers.UvicornWorker。
  3. 虚拟环境激活后,pip install 装到哪里?怎么验证?
    • 要点:装到 .venv/lib/pythonX.Y/site-packages(Windows 是 .venv\Lib\site-packages);用 python -c "import sys; print(sys.prefix)" 验证。
  4. 405 和 404 的区别是什么?接口返回 405 应该改 URL 还是改方法?
    • 要点:404 路径不存在,405 路径存在但方法不对;改路由方法声明,不改 URL。
  5. 为什么 .venv/ 不能提交进 Git?
    • 要点:环境与机器、解释器版本、操作系统绑定;依赖应通过 requirements.txt 或锁文件复现。
  6. Nginx 反向代理时,后端怎么拿到客户端真实 IP?
    • 要点:Nginx 通过 X-Forwarded-For 头传递,后端读这个头而不是连接的远端地址。