Python入门第一课：用虚拟环境把第一个小项目管起来

刚开始学 Python 的人常遇到这样一个尴尬：教程里的代码明明照着敲，自己电脑上却跑不起来；或者上周还能运行的脚本，装了一个新库之后就开始报错。很多时候问题不在代码本身，而在环境——不同项目依赖不同版本的库，全部装进系统全局环境里，迟早会互相打架。虚拟环境要解决的正是这件事：给每个项目单独准备一个小房间，库装在房间里，项目之间互不干扰。

一、先确认 Python 能用

打开终端，输入 python --version，能看到类似 Python 3.11 的版本号，说明解释器已经就绪。如果提示找不到命令，先检查安装时是否勾选了把 Python 加入 PATH。这一步不要跳过，后面所有命令都建立在它能被终端找到的前提上。

二、给项目建一个专属环境

新建一个项目文件夹，比如 my_first_app，进入该文件夹后执行：python -m venv .venv。这条命令会在当前目录生成一个名为 .venv 的文件夹，里面是一套独立的 Python 和 pip。接着激活它：Windows 下执行 .venv\Scripts\activate，macOS 和 Linux 下执行 source .venv/bin/activate。激活成功后，终端提示符前面会出现 (.venv) 字样，这就是以后判断自己是否在正确环境里的最直观标志。退出环境只需要输入 deactivate。

三、在环境里装库并留下清单

激活状态下执行 pip install requests，库只会装进 .venv，不会污染全局。写一个最小脚本 test.py，内容只有两行：import requests，然后 print(requests.__version__)，运行 python test.py 能打印出版本号，说明安装和导入都通了。最后执行 pip freeze > requirements.txt，把当前环境的依赖清单保存下来。以后换电脑或把项目发给同事，对方只要新建虚拟环境，再执行 pip install -r requirements.txt，就能还原出一模一样的环境，这是新手最容易忽略、却最省时间的一步。

四、三个常见坑

第一，忘了激活就装库，结果库装到了全局，脚本在环境里反而找不到。养成习惯：装库和运行前先看提示符有没有 (.venv)。第二，把 .venv 文件夹本身提交到代码仓库，它体积大又和操作系统相关，正确做法是只提交代码和 requirements.txt，并在 .gitignore 里写上 .venv。第三，多个项目共用一个环境，省事一时，冲突迟早找上门，一个项目一个环境才是常态。

写在最后

虚拟环境不是什么高深技巧，它更像整理书桌：东西分门别类放好，后面找起来才不乱。把创建、激活、装库、导出清单这四步练成肌肉记忆，之后学爬虫、做小工具、尝试数据分析时，你会少踩很多莫名其妙的坑。下一篇不妨试着在这个环境里写一个读取本地文本并统计词频的小脚本，把今天的环境真正用起来。