当前位置:首页>python>我的 Python 学习日记25

我的 Python 学习日记25

  • 2026-09-30 22:23:25
我的 Python 学习日记25

太棒了,我们按计划顺利进入【GitHub 驾驭战略规划】的第二阶段:开源项目生存技能!

如果你曾经尝试过从网上下载别人的 Python 代码来运行,大概率见过屏幕上蹦出这样一行红字:
ModuleNotFoundError: No module named 'xxx'(找不到模块)。

无数新手在这个报错面前怀疑人生、甚至放弃。但今天过后,这个报错对你来说将不再是噩梦,而是你动手改造项目的冲锋号!

⸻

📝 Python 修炼日记:配置生存环境(告别 ModuleNotFoundError)
🗓️ 日期:2026-04-16
🎯 今日目标:彻底搞懂 pip、虚拟环境 (venv) 以及 requirements.txt,让别人的 GitHub 项目在你的电脑上完美跑通!

📖 核心概念

1. pip:Python 的“软件商店”
Python 自带了一些基础功能(比如 math、os、json),但 GitHub 上的项目往往需要更强大的第三方工具(比如用来做网页爬虫的 requests,用来做 AI 的 numpy)。
pip 就是 Python 官方的包管理工具,相当于苹果手机的 App Store。缺什么工具,直接用 pip install 就能下载。

2. 虚拟环境(Virtual Environment,简称 venv):项目的“独立隔离房”
假设你下载了两个 GitHub 项目:

  • • 项目 A(旧项目):需要 requests 的 1.0 版本。
  • • 项目 B(新项目):需要 requests 的 2.0 版本。
    如果你把它们都安装在电脑的全局环境里,这两个版本就会“打架”,导致其中一个项目直接崩溃。

高级开发者的解决办法是: 绝不在电脑全局环境里乱装东西。每拿到一个新项目,就给它建一个独立的“虚拟环境”(像一间隔离的小房间)。在 A 房间装 1.0,在 B 房间装 2.0,井水不犯河水!

3. requirements.txt:采购清单
当你搞定了一个项目,怎么告诉别人你需要哪些包和版本呢?开发者通常会写一个 requirements.txt 文件。这就像一张“采购清单”,别人拿到清单后,一键就能买齐所有需要的工具。

📊 知识汇总表

环境配置四大核心指令(在命令行/终端中输入)

操作目标
Windows 命令
Mac / Linux 命令
核心含义
创建虚拟环境python -m venv venvpython3 -m venv venv
在当前目录下,盖一间名叫 venv 的空房间。
激活虚拟环境venv\Scripts\activatesource venv/bin/activate开门进房间!
(成功后命令行前面会多出 (venv) 字样)
安装单个工具包pip install requestspip install requests
在当前房间里,去商店买一个叫 requests 的工具。
按清单批量安装pip install -r requirements.txtpip install -r requirements.txtGitHub 终极杀招
:照着清单,把需要的工具一次性全部买齐!

⚙️ 逻辑与流程

当你从 GitHub 下载了一个项目(里面包含 main.py 和 requirements.txt),你标准的执行流程应该是这样的:

有

没有 (或者个别漏了)

步骤 1: 下载代码并进入项目文件夹
步骤 2: 创建虚拟环境 (python -m venv venv)
步骤 3: 激活虚拟环境 (进入隔离模式)
项目里有 requirements.txt 吗?
步骤 4: 执行 pip install -r requirements.txt
直接运行,如果报错缺少什么,就单独 pip install 什么
步骤 5: 环境配置完成,运行主程序 (python main.py) !

💻 实战演练

想象一下,你刚才克隆了一个自动发邮件的开源小工具。打开命令行(Terminal),你只需要敲这三行代码,就能像专业程序员一样跑起它:

# 1. 建房子:创建一个叫 myenv 的虚拟环境
python -m venv myenv

# 2. 进房子:激活它(以 Windows 为例。你会发现命令行开头变成了 (myenv) )

myenv\Scripts\activate

# 3. 按清单采购:一键安装原作者要求的所有依赖

pip install -r requirements.txt

# 4. 享受成果:运行程序!

python main.py

提示:如果不想玩了,输入 deactivate 就能退出这个虚拟房间。

💡 今日感悟

今天完成了从“写脚本”到“搞工程”的关键跨越。
虚拟环境保持了电脑的干净整洁,而 requirements.txt 则是连接原作者与你的桥梁。 以后看到 ModuleNotFoundError,不要慌,说明你只是忘记激活虚拟环境,或者忘记用 pip 安装它罢了!

最新文章

随机文章