WEEK 02 / 16 环境与工具链 · AI 环境 / 包管理器 / Python 环境
PYTHON 程序设计 · V2 · 第 2 周(100 分钟)

环境与工具链
配好 AI 环境,搞懂 Python 环境

今天务实:把 AI 开发环境配好(Zcode + 校内 OpenAI 平台),把包管理器与 Python 环境的关系讲清楚, 最后学会读报错——这门课的基本功。

所属模块 M1 环境与工具链第二课 · 务实← → 翻页 · F 全屏

今日课表(100 分钟)

时间环节要点
0–8开场回顾上周务虚讲概念——这节课务实:环境与工具链
8–22配 AI 环境Zcode 下载 → 选「使用 API key」→ 校内 OpenAI 平台统一认证 → 拿三样东西配供应商
22–34包管理器概念winget / brew / apt / pip / npm——所有包管理器是同一个架构(索引服务器 + 文件服务器)
34–52Python 环境史官方安装包 / Miniconda / UV——它们各包含什么、解决什么问题
52–66虚拟环境拆解venv 里到底装了什么;激活环境本质是设置环境变量(activate.ps1 看一眼)
66–78动手初始化打开文件夹 → AI 帮我初始化环境 → 跑第一个 main.py
78–88读报错从最后一行往前读;找不到文件多半是目录没切换
88–95AI 环境收尾测试配置;别把账号密码写进代码
95–100小结与课后下周进入语言核心:类型与数据结构

← → 翻页;带分步的页面按 → 逐条展开。学生打开本页即可参与练习与测验。

把 AI 开发环境配好

以 Zcode 为例(Trae / Cursor 等其他工具同理)——核心是给工具配好后台模型:

下载 Zcode
官网自适应系统
→
选「使用 API key」
暂时跳过登录
→
校内 OpenAI 平台
统一认证登录
→
添加供应商
配好后台模型
需要拿到的三样东西: ① Base URL(服务器在哪,校内是 openai.cuc.edu.cn)② API Key(控制台创建,永不过期) ③ 模型 ID(比如 deepseek-cuc)——三者齐了,工具就变成 Agent 了。

包管理器:都是同一个架构

你的终端
pip install requests
→
索引服务器
这本书的目录(轻、快)
→
文件服务器
真正的包(大、可 CDN 加速)

理解了架构,换语言换系统都不再陌生——这是「学思想而非背命令」的第一个例子。

Python 环境:三种选择

官方安装包Python 3.14.x + pip
  • python.org 下载,自带 pip
  • 装包要编译时很痛苦(需要本地编译环境)
Anaconda → Miniconda科学计算全家桶 / 精简版
  • Anaconda 900M+ 塞 500 个科学计算包(太重)
  • Miniconda ≈ 90M:Python + conda + 少量默认包——推荐用它上课
UV新一代包管理器 用 Rust 写的、更快;虚拟环境放在项目文件夹里(conda 默认堆在 C 盘用户目录下)。 推荐 Miniconda + UV 都装上。

虚拟环境:到底是什么

  • 虚拟环境 = 项目专属的独立 Python 空间(envs 文件夹)
  • 激活环境 = 运行一堆设置环境变量的逻辑(看 activate.ps1 就明白)
  • UV 的虚拟环境在项目文件夹里;conda 默认堆在 C 盘
# 激活后,项目里的脚本这么跑:
uv run main.py          # UV 帮你激活虚拟环境再执行
# 或手动:
.venv\Scripts\activate  # Windows
python main.py

虚拟环境里很干净——只有 Python + pip + 你自己装的库。这正是「我对这个环境有把握」的原因。

动手:让 AI 帮你初始化环境

在桌面上建一个项目文件夹(建议英文名,比如 python-course),然后在 AI 工具里:

"我现在这个项目想用 Python 做,用 UV 作为包管理器,
 帮我在本地初始化所需环境。"

文件夹别用中文名——中文路径在很多工具里会有莫名其妙的坑。

读报错:本课的基本功

# 常见错误:文件找不到
C:\Users\me> python hello.py
python: can't open file 'hello.py': [Errno 2] No such file or directory

# 读报错从最后一行往前读——原因:你不在 hello.py 所在的目录
C:\Users\me> cd Desktop\python-course
C:\Users\me\Desktop\python-course> python hello.py
Hello, world!

交互演示:编译 vs 解释

可交互演示 · 页内直接操作

点「播放」或逐步执行,观察同一段程序在 C 与 Python 两条流水线上的处理过程——为什么 Python 保存即可运行,答案就在这里。 新窗口打开 →

随堂小测(3 题)

交互 · 点击选项作答

课后与下周预告

本周课后
  • 把 Zcode 配上校内平台(Base URL / API Key / 模型 ID),跑通一次对话
  • 装好 Miniconda + UV;在桌面建一个英文项目文件夹,让 AI 帮你初始化环境
  • 练习读报错:故意在错误的目录下跑 python hello.py,看懂报错
下周:W3 类型与数据结构 环境就绪,开始写代码——拿真实 API 返回的数据当教材:变量与类型 → 四种数据结构怎么选。 提前看下周课件 →

深入阅读:M1 模块页 · 经典笔记 3.2 环境变量 · 10.5 虚拟环境管理