【EPGF 白皮书】路径治理驱动的多版本 Python 架构—— Windows 环境治理与 AI 教学开发体系
EPGF 新手教程第 00 篇
一次搭好、终身不乱：Windows Python 环境治理（EPGF）系列总览 / 阅读路线图
一、你是不是也经历过这些“环境崩溃瞬间”？
明明装了 Python，却不知道系统在用哪个
PyCharm 里能跑，终端却报错
装了 poetry / uv / pipenv，却互相打架
项目删了又建，环境越用越乱
换电脑 / 重装系统 = 一切从零开始
如果你对其中任何一条点头，那么你遇到的不是技术问题，而是：
👉从一开始就没人教你：Windows 上的 Python 环境应该如何“治理”
二、EPGF 不是工具，而是一套「长期不乱」的环境治理逻辑
EPGF，全称Engineering Python Governance Framework。
它不发明新工具，也不替代现有方案，而是回答三个被长期忽略的问题：
Python 应该装在哪？
不同 Python 版本如何共存而不互相污染？
项目环境、工具链、IDE 如何各司其职？
EPGF 的目标只有一个：
让你的 Windows 电脑，在 5 年、10 年后，依然清楚、可控、可迁移。
三、如果你完整跟完本系列，最终会落在这样一个结构
⚠️ 说明：
下面不是教程，不需要现在照做
它只是让你提前知道：终点长什么样
D:\A\ │ ├─ envs\ ← 所有 Python 版本统一的入口（Anaconda/envs） │ ├─ py310\ │ │ ├─ python.exe │ │ └─ Scripts\ │ │ ├─ pip.exe │ │ ├─ uv.exe │ │ ├─ poetry.exe │ │ ├─ hatch.exe │ │ └─ ... │ ├─ py311\ │ └─ py312\ │ └─ py313\ │ └─ py314\ │ └─ py3**\ │ │ ├─ Projects\ │ ├─ demo_project\ │ │ ├─ .venv\ ← 项目自己的环境 │ │ └─ pyproject.toml │ └─ ...🧩 然后你可以这样轻松灵活地切换 Python 版本:
conda activate py3xx后面的所有文章，只是在解释一件事：
如何一步步、可复现、可回退、可迁移地，走到这个结构。
四、本系列不是“命令合集”，而是一条「新手可走通的路线」
为了避免新手一开始就被命令吓退，EPGF 新手教程刻意遵循三条原则：
能 GUI 就不用命令
先解释“为什么”，再讲“怎么做”
先解决结构问题，再谈效率工具
所以你会看到大量这样的设计：
先用 PyCharm 理解“项目级环境”
再理解为什么工具链不能乱装
最后才接触 uv / poetry / hatch 这些名字
五、EPGF 新手教程（01–08）阅读路线说明
⚠️ 以下顺序强烈建议按编号阅读
01｜为什么 EPGF 能在一台 Windows 上搞定所有虚拟环境
02｜Anaconda 正确安装与路径一次性治理
03｜在一台 Windows 上创建多个 Python 版本（全 GUI）
04｜PyCharm 如何自动帮你实现项目级隔离
05｜项目已隔离，为什么环境还是会乱？
06｜为什么工具要“住进 Python 版本里”
07｜一次看懂所有虚拟环境工具到底是什么
08｜为什么工具链必须跟着 Python 版本走
读完这 8 篇，你至少会得到三样东西：
一套能长期维持稳定的结构
一种判断“环境是否健康”的能力
一张不再被工具牵着走的认知地图
六、你可以把 EPGF 当成什么？
✔ 不是教程合集
✔ 不是速成技巧
✔ 不是“大神推荐配置”
而是：
一套适合普通人、但能用很多年的 Windows Python 环境秩序。
七、从这里开始
如果你是第一次看到这个系列：
👉请从第 01 篇开始
如果你已经在中途迷路：
👉请回到这一篇，对照结构重新定位自己的多版本 Python 治理架构。
八、后续说明
后续文章将在此基础上，继续展开：
工具链更深入的使用方式
教学与团队场景
AI 项目与复杂依赖治理
本篇（00）将长期作为：
EPGF 系列的总入口 / 阅读导航 / 回到原点的地方
建议收藏。
