【EPGF 白皮书】路径治理驱动的多版本 Python 架构------ Windows 环境治理与 AI 教学开发体系
EPGF 新手教程 01为什么 EPGF 能在一台 Windows 上,搞定所有虚拟环境?------一次搭好,终身不乱的 Python 环境治理逻辑(新手也能看懂)
EPGF 新手教程 02第一次安装就不踩坑:Anaconda 正确安装与路径一次性治理------把 Python 安装在 D:\A,从此不再折腾环境变量
本文语言刻意压低理解门槛,不假设读者懂命令行、不假设读者懂虚拟环境,完全站在"第一次真正把项目管清楚"的新手视角来写。
EPGF 新手教程 04
一个项目一个环境:PyCharm 是如何帮你"自动隔离"的?(全 GUI,新手零命令)
如果你已经完成了前两篇教程的操作,那么恭喜你一件事:
你的电脑上,已经拥有一个"干净、可控、不会乱"的 Python 系统底座了。
-
Python 装在了
D:\A -
不在 C 盘
-
不再和系统权限纠缠
-
可以全局使用
但是,从这一篇开始,我们要解决一个更现实、更致命的问题:
为什么我一做项目,环境还是会乱?
一、很多人卡死在这里:
"我已经装好 Python 了,为什么项目还是会出问题?"
先来看几个你一定见过、甚至亲身经历过的场景:
-
❌ A 项目能跑,B 项目一运行就报错
-
❌ 昨天刚装好的库,今天提示"找不到模块"
-
❌ 为了一个新项目,卸了半天旧库,结果老项目全炸
-
❌ 明明用的是同一台电脑,为什么环境像"精神分裂"?
如果你点头了,请放心:
不是你不会用 Python,而是你还没进入"项目级环境"的世界。
二、一个非常重要、但很少有人讲清楚的事实
Python 的混乱,99%不是"版本问题",而是"项目共用环境"的问题。
我们用一句小学生都能懂的话来说清楚:
🌰 举个生活中的例子
想象一下:
-
你的电脑 = 一栋楼
-
Python = 楼里的水电系统
-
项目 = 一间一间的房子
如果你把 所有项目的依赖 都装在同一个地方,相当于:
👉 所有房子的家具、床、桌子、冰箱
👉 全部堆在走廊里,谁都能改,谁都能动
那结果只有一个:
迟早会乱。
三、EPGF 的核心原则之一:
一个项目,就该有一个"自己的环境"
这一步,在 EPGF 里有一个非常重要的名字:
🎯 项目级隔离
但别被名字吓到,我们暂时不讲概念,只讲一句话:
这个项目用的 Python 和库,只属于它自己。
那问题来了:
❓ 我是不是又要敲一堆命令?
❓ 是不是又要学一套新工具?
答案:不需要。
因为------
👉 PyCharm 已经帮你把这件事"做成按钮"了。
四、PyCharm:新手最大的隐藏神器
很多新手以为:
PyCharm = 写代码的编辑器
但在 EPGF 架构里,PyCharm 的真正身份是:
✅ 项目环境管理器(GUI 版)
从这一篇开始,你会发现一件事:
你几乎不用自己"管理环境"
PyCharm 会在你点鼠标的过程中,悄悄帮你管好一切

五、实战开始:
用 PyCharm 创建"真正属于项目的 Python 环境"
下面我们一步一步来,每一步都能看到画面。
第一步:新建一个项目(重点不是代码)
1️⃣ 打开 PyCharm
2️⃣ 点击 New Project(新建项目)
你会看到一个非常关键的区域:
Python Interpreter(Python 解释器)
第二步:你要做的唯一正确选择
在解释器设置区域,请注意这几个选项:
-
✅ New environment using Virtualenv
-
❌ 不选 Existing
-
❌ 不选系统 Python
你会看到 PyCharm 自动帮你做了几件事:
-
在项目目录下
-
准备创建一个
.venv文件夹 -
并且让它 只服务于这个项目
👉 这一步,就是"项目级隔离"的诞生瞬间。
第三步:基于哪个 Python?
这里你只需要做一件事:
从下拉框中,选择你已经安装好的 Anaconda Python
比如:
D:\A\python.exe或对应版本
注意重点:
-
❌ 不需要记路径
-
❌ 不需要复制命令
-
❌ 不需要理解底层
你只是 点选 → 创建。

六、.venv 是什么?(不讲原理,只讲作用)
当项目创建完成后,你会在项目目录看到一个新东西:
your_project/
├─ .venv/
├─ main.py
└─ ...
此时你只需要记住一句话:
.venv= 这个项目的"私人 Python 小房间"
-
它有自己的 Python
-
它有自己的库
-
它和其他项目 完全无关
一个非常重要的认知转变
从现在开始:
❌ 你不再是"给电脑装库"
✅ 而是"给项目装库"
这是新手 → 正确使用者的分水岭。
七、在 PyCharm 里安装库(不碰命令行)
我们继续用 GUI。
正确方式(强烈推荐新手)
1️⃣ 打开 Settings / Preferences
2️⃣ 找到 Python Interpreter
3️⃣ 点击右侧的 +
4️⃣ 搜索你要的库
5️⃣ 点击 Install
你会发现:
PyCharm 自动把库装进了
.venv

为什么这是"安全"的?
因为让环境跟随项目:
-
删项目 = 删环境
-
不会污染系统
-
不会影响其他项目
-
不存在"卸库把别的项目搞炸"
八、现在,请你停下来,回顾一眼你已经拥有的东西
如果你完成了本篇操作,那么现在你的 Windows 上已经有:
✅ 第 1 层:系统级 Python(Anaconda,D:\A)
-
稳定
-
不乱
-
几乎不动
✅ 第 2 层:项目级环境(.venv)
-
一个项目一个
-
自动创建
-
自动绑定
你已经自然进入了 EPGF 的"四级隔离体系"中的核心两级 ,
只是你还没意识到而已。
九、常见新手疑问(你可能正在想)
❓ 我能不能不用 PyCharm?
可以,但不推荐新手一开始脱离 GUI。
❓ .venv 会不会很占空间?
不会,而且这是"空间换秩序",非常值得。
❓ 我需要记住 .venv 里的东西吗?
不需要,
你只需要记住:这个项目是"独立的"。
十、这一篇你真正应该带走的,不是操作
而是这三个认知:
1️⃣ Python 不乱,是因为有人管
2️⃣ 项目不乱,是因为环境不共享
3️⃣ PyCharm 不是编辑器,是环境管家
下一篇预告
你现在可能会想:
"那我用到的工具呢?"
"black、pytest、ruff 这些怎么办?"
"它们会不会又把环境搞乱?"
放心。
👉 下一篇,我们专门讲:
EPGF 新手教程 05:
为什么工具也要"住进项目里"?
从 pip 到 black,一切都不再污染系统
那一篇,会让你真正理解:
为什么 EPGF 能在一台 Windows 上,搞定所有类型的虚拟环境。