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

EPGF 新手教程第 00 篇

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

---

一、你是不是也经历过这些“环境崩溃瞬间”？

• 明明装了 Python，却不知道系统在用哪个

• PyCharm 里能跑，终端却报错

• 装了 poetry / uv / pipenv，却互相打架

• 项目删了又建，环境越用越乱

• 换电脑 / 重装系统 = 一切从零开始

如果你对其中任何一条点头，那么你遇到的不是技术问题，而是：

👉 从一开始就没人教你：Windows 上的 Python 环境应该如何“治理”

---

二、EPGF 不是工具，而是一套「长期不乱」的环境治理逻辑

EPGF，全称 Engineering Python Governance Framework。

它不发明新工具，也不替代现有方案，而是回答三个被长期忽略的问题：

1. Python 应该装在哪？

2. 不同 Python 版本如何共存而不互相污染？

3. 项目环境、工具链、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 上搞定所有虚拟环境

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

• 02｜Anaconda 正确安装与路径一次性治理

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

• 03｜在一台 Windows 上创建多个 Python 版本（全 GUI）

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

• 04｜PyCharm 如何自动帮你实现项目级隔离

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

• 05｜项目已隔离，为什么环境还是会乱？

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

• 06｜为什么工具要“住进 Python 版本里”

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

• 07｜一次看懂所有虚拟环境工具到底是什么

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

• 08｜为什么工具链必须跟着 Python 版本走

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

读完这前 8 篇，你至少会得到三样东西：

• 一套能长期维持稳定的结构

• 一种判断“环境是否健康”的能力

• 一张不再被工具牵着走的认知地图

---

六、你可以把 EPGF 当成什么？

• ✔ 不是教程合集

• ✔ 不是速成技巧

• ✔ 不是“大神推荐配置”

而是：

一套适合普通人、但能用很多年的 Windows Python 环境秩序。

---

七、从这里开始

如果你是第一次看到这个系列：

👉 请从第 01 篇开始

如果你已经在中途迷路：

👉 请回到这一篇，对照结构重新定位自己的多版本 Python 治理架构。

---

八、后续说明

后续文章将在此基础上，继续展开：

• 工具链更深入的使用方式

• 教学与团队场景

• AI 项目与复杂依赖治理

本篇（00）将长期作为：

EPGF 系列的总入口 / 阅读导航 / 回到原点的地方

建议收藏。

---