一次搭好、终身不乱Windows Python 环境治理（EPGF）系列总览 / 阅读路线图 [目录]

【EPGF 白皮书】路径治理驱动的多版本 Python 架构—— Windows 环境治理与 AI 教学开发体系

一次搭好、终身不乱

Windows Python 环境治理（EPGF）系列总览 / 阅读路线图 [目录]

EPGF（Engineering Python Governance Framework）
一套专为 Windows 设计的 Python 环境治理与教学落地体系
—— 用工程化方法，终结“环境地狱”

一、这不是一套“工具教程”，而是一套环境治理体系

如果你点进这个系列，是因为你曾遇到过下面任意一种情况：

• Python 装了，但不知道现在用的是哪个
• 项目能跑，但换电脑 / 换同学就全崩
• 虚拟环境创建了，依赖却“跑丢了”
• 工具越装越多，C 盘越来越乱
• 教学中 30 个学生 = 30 种环境问题

那么你需要的不是“再学一个工具”，
而是一套 可控、可迁移、可复现的治理方案。

这正是 EPGF 架构存在的意义。

二、EPGF 系列整体结构说明（先看这个）

整个系列 00–25 篇，并不是零散文章，而是三条清晰主线：

🧱 第一主线：基础架构与路径治理（00–08）

解决的问题是：

为什么 Windows 下 Python 总是乱？
以及，如何从根上把它“一次搭好”。

🧰 第二主线：现代工具链 + 工具本地化（09–14）

解决的问题是：

uv / poetry / hatch / pipenv
到底该怎么“正确地”用在 Windows + PyCharm 里？

pip install uv poetry hatch pipenv virtualenv pipx nox tox poetry-plugin-shell # 安装后可执行文件（.exe）统一入口在 D:\A\envs\py3xx\Scripts\

🎓 第三主线：教学落地与规模化复现（15–25）

解决的问题是：

当 Python 不再是个人开发，而是课程 / 教学 / 实验环境时，
如何做到“学生一键复现，教师可控验收”？

三、EPGF 系列完整目录（00–25 篇）

📌 建议新读者 严格按顺序阅读
每一篇，都是后续内容的“地基”

🟦【总览与认知校准】

EPGF 系列 00｜总览篇
一次搭好、终身不乱：Windows Python 环境治理【系列总览 / 阅读路线图】

EPGF 新手教程 00一次搭好、终身不乱：Windows Python 环境治理（EPGF）系列总览 / 阅读路线图

🧱【第一部分：基础架构与路径治理（01–08）】

01｜为什么 EPGF 能在一台 Windows 上，搞定所有虚拟环境？
—— 一次搭好，终身不乱的 Python 环境治理逻辑（新手也能看懂）

EPGF 新手教程 01为什么 EPGF 能在一台 Windows 上，搞定所有虚拟环境？——一次搭好，终身不乱的 Python 环境治理逻辑（新手也能看懂）

02｜第一次安装就不踩坑：Anaconda 正确安装与路径一次性治理
—— 把 Python 安装在 D:\A，从此不再折腾环境变量

EPGF 新手教程 02第一次安装就不踩坑：Anaconda 正确安装与路径一次性治理——把 Python 安装在 D:\A，从此不再折腾环境变量

03｜不用重装、不用记命令，在一台 Windows 上创建多个 Python 版本（全 GUI）

EPGF 新手教程 03不用重装、不用记命令在一台 Windows 上创建多个 Python 版本（全图形界面）

04｜一个项目一个环境：PyCharm 是如何帮你“自动隔离”的？（全 GUI）

EPGF 新手教程 04一个项目一个环境：PyCharm 是如何帮你“自动隔离”的？（全 GUI，新手零命令）

05｜项目已经隔离了，为什么环境还是会乱？
—— 被 90% 新手忽略的“工具污染”

EPGF 新手教程 05项目已经隔离了，为什么环境还是会乱？——被 90% 新手忽略的“工具污染”，才是真正的隐形杀手

06｜一次安装，全局可用：为什么工具要“住进 Python 版本里”？

EPGF 新手教程 06一次安装，全局可用：为什么工具要“住进 Python 版本里”？

07｜所有虚拟环境工具到底是什么？
—— venv / virtualenv / conda / uv / poetry / hatch 一次看懂

EPGF 新手教程 07所有“虚拟环境工具”到底是什么？——一次看懂 venv / virtualenv / conda / uv / poetry / hatch（不再混乱）

08｜一次装齐所有工具链，为什么必须跟着 Python 版本走？
—— 工具本地化，才是 Windows 永不混乱的终极解法

EPGF 新手教程 08一次装齐所有工具链，为什么必须跟着 Python 版本走？——工具本地化，才是 Windows 上永不混乱的终极解法（新手必读）

🧰【第二部分：工具链专题 + 工具本地化（09–14）】

09｜工具本地化：为什么项目必须自带工具链？（关键认知篇）

EPGF 新手教程 09｜工具本地化：为什么项目必须自带工具链？——只有 .venv 真正“自给自足”，环境才能迁移、复现、长期不乱（新手必读）

10｜PyCharm + venv：最稳定的项目级虚拟环境创建方式（GUI）

EPGF 新手教程 10｜virtualenv：PyCharm 是如何创建第一个“真正自包含”的项目环境的？

11｜uv 环境（GUI + 工具本地化）
—— 父级 Python、uv.exe 来源与项目自包含的正确姿势

EPGF 新手教程 11在 PyCharm（中文版 GUI）中创建 uv 环境，并把 uv 做到“项目自包含”（工具本地化为必做环节）

12｜Poetry 环境（GUI + 工具本地化）
—— pyproject.toml 背后的治理逻辑

EPGF 新手教程 12在 PyCharm（中文版 GUI）中创建 Poetry 项目环境，并把 Poetry 做成“项目自包含”（工具本地化为必做环节）

13｜Hatch 在 EPGF 中的真实定位
—— 为什么它更像“项目管理器”而不是 IDE 工具

EPGF 新手教程 13在 PyCharm（中文版 GUI）中创建 Hatch 项目环境，并把 Hatch 做成“项目自包含”（工具本地化为必做环节）

14｜Pipenv 的正确打开方式（EPGF 校准版）
—— 为什么默认行为不适合教学与迁移，以及如何规避

EPGF 新手教程 14Pipenv 的默认行为与 Windows 环境治理冲突分析

为什么 hatch 和 pipenv 在 PyCharm 里“行为异常”？——EPGF 架构下的工具真实定位与责任边界（认知纠偏篇）

🎓【第三部分：教学落地与规模化实践（15–25）】

15｜EPGF 工具链选型指南（新手 / 教学 / AI 项目）

EPGF 新手教程 15工具这么多，我该选哪个？——在 EPGF 架构下做出“不会后悔”的选择

16｜AI 项目实战：用 EPGF 搭建 PyTorch 开发环境

EPGF 新手教程 16 构建工具本地化全景篇：为什么“装了≠属于项目”？

17｜大型 AI 项目的环境治理（以 Stable Diffusion 为例）

EPGF 新手教程 17 IDE 不是环境：PyCharm / VS Code 与真实 Python 运行时的边界澄清——EPGF 架构中的「执行责任」与「认知纠偏」篇

18｜教学场景下的环境设计原则（教师视角）

EPGF 新手教程 18 到底是谁在运行你的 Python 代码？——从 IDE 点击 Run 到字节码执行的完整链路拆解（EPGF 执行真相篇）

19｜Windows + EPGF 常见问题与系统级排错指南

EPGF 新手教程 19 为什么 EPGF 必须「先建 .venv，再谈工具」？——项目级环境先行，是一切可迁移与可复现的工程前提

20｜EPGF 架构总复盘：从个人开发到工程治理

EPGF 新手教程 20一次打包带走：EPGF 项目如何实现「整目录迁移 + 原样复现」？

21｜EPGF 教学体系总览：从课堂到实验室

EPGF 新手教程 21把“环境折磨”从课堂中彻底移除：EPGF 如何重构 AI / Python 教学环境？

22｜教师端：EPGF 教学环境的整体设计与发布流程

EPGF 新手教程 22教学模板不是压缩包：EPGF 如何设计“可复制、可检查、可回收”的课程模板？

23｜学生端：一键复现完整教学环境的标准流程

EPGF 新手教程 23学生端一键复现流程：从老师发你一个文件夹开始，你只需要这几步

24｜教学模板工程是如何制作的（教师篇）

EPGF 新手教程 24教学模板工程是如何制作的？——教师端一次设计，学生端无限复现

25｜教学环境的验收与评分自动化
—— 助教与课程规模化实践

2025 PyCharm IDE 社区版与专业版合并后，新手该如何安装？（附 Toolbox 图形化安装教程）

四、你应该如何使用这套系列？

👩‍💻 如果你是个人开发者

→ 阅读 01–14
你会彻底摆脱“环境焦虑”。

👨‍🏫 如果你是教师 / 助教

→ 阅读 01–08 + 18–25
你会得到一套“可复制”的教学系统。

👥 如果你在做培训 / 实验室 / AI 教学

→ 全套必读

五、最后说明

EPGF 不是“唯一方案”，
但它是一套 在 Windows 上，被完整验证过、能落地、能教学、能规模化的方案。

如果你曾被环境问题消耗过时间，
希望这个系列，能帮你把时间还回来。

【00】EPGF 架构搭建教程之 总揽篇

【01】EPGF 架构搭建教程之 Anaconda 安装指南

【02】EPGF 架构搭建教程之 Python 多版本配置

【03】EPGF 架构搭建教程之 虚拟环境管理工具的安装

【04】EPGF 架构搭建教程之 工具环境变量的配置

【05】EPGF 架构搭建教程之 创建虚拟环境实战演示

【06】EPGF 架构搭建教程之 本地环境管理工具的本地化