第4章:开发环境搭建——Git、VS Code、Python 3.x 及虚拟环境

好,咱们开始动手搭环境了。

说实话,很多初学者一上来就急着写代码,结果环境没配好,后面各种报错。我见过太多人卡在「pip install 失败」或者「明明装了 Python 但终端找不到」这种问题上。所以这一章,咱们稳扎稳打,把地基打牢。

4.1 安装 Git:版本控制的起点

Git 这东西,说白了就是个「后悔药」加「时光机」。你写代码写到一半,想回退到昨天的版本?Git 帮你搞定。你想看看同事改了啥?Git 也帮你搞定。

安装步骤:

  1. git-scm.com 下载对应系统的安装包。
  2. Windows 用户一路 Next,但注意这一步:选择「Use Git from the command line and also from 3rd-party software」。我当初选错了,结果在 VS Code 里死活找不到 Git,折腾了半天。
  3. Mac 用户建议用 Homebrew:brew install git。Linux 用户 sudo apt install git 就行。
小技巧:安装完后,打开终端(CMD 或 PowerShell),输入 git --version。如果看到版本号,说明装好了。如果报错,重启一下终端再试。

配置你的身份:

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

嗯,这里要注意:邮箱最好用 GitHub 注册的那个,不然以后提交记录里头像显示不出来。

4.2 安装 VS Code:写代码的利器

编辑器我推荐 VS Code,原因很简单:免费、插件多、社区活跃。我这些年用过 Sublime、Atom、WebStorm,最后还是回到了 VS Code。为什么?因为它的插件生态太强了。

安装步骤:

  1. code.visualstudio.com 下载安装包。
  2. 安装时记得勾选「Add to PATH」和「Open with Code」这两个选项。这样你在文件夹上右键就能直接打开 VS Code。

必装插件清单:

插件名 作用
Python 语法高亮、代码补全、调试
GitLens 可视化 Git 历史,谁改了哪一行一目了然
Markdown Preview Enhanced 写文档时实时预览
Bracket Pair Colorizer 括号配对着色,找 bug 时救命用的
避坑指南:我曾经装了一堆花里胡哨的主题插件,结果 VS Code 启动慢得像蜗牛。后来学乖了,只装真正需要的。插件不是越多越好。

4.3 安装 Python 3.x:核心引擎

Python 版本怎么选?我建议直接上 Python 3.10 或 3.11。别用 3.12 以下的老版本,也别追最新版(比如 3.13 刚出时兼容性可能有问题)。

安装步骤:

  1. python.org 下载对应系统的安装包。
  2. Windows 用户:一定要勾选「Add Python to PATH」。这个不勾,后面你在终端里打 python 会提示找不到命令。
  3. Mac/Linux 用户建议用 pyenv 管理多版本,但新手直接系统安装也行。

验证安装:

python --version
pip --version

如果 pip 版本太旧,升级一下:

python -m pip install --upgrade pip

4.4 虚拟环境:隔离的艺术

为什么需要虚拟环境?你想想看,项目 A 需要 Django 3.2,项目 B 需要 Django 4.0。如果全装到系统里,早晚会冲突。虚拟环境就是给每个项目一个「独立的小房间」。

创建虚拟环境:

# 在项目目录下执行
python -m venv venv

第一个 venv 是模块名,第二个 venv 是文件夹名。你可以改成别的名字,比如 .envmyenv,但业内习惯用 venv

激活虚拟环境:

  • Windows:venv\Scripts\activate
  • Mac/Linux:source venv/bin/activate

激活后,终端前面会出现 (venv) 字样。这时候你安装的所有包都只在这个项目里生效。

重要:退出虚拟环境用 deactivate。我刚开始用的时候经常忘了退出,结果在别的项目里 pip list 一看,一堆不相干的包,乱得很。

管理依赖:

# 生成依赖清单
pip freeze > requirements.txt

# 别人拿到项目后,一键安装
pip install -r requirements.txt

这个 requirements.txt 就是项目的「药方」。你想想看,团队协作时,每个人只要跑一遍 pip install -r requirements.txt,环境就一模一样了。是不是很爽?

4.5 验证环境是否就绪

最后,咱们写个简单的脚本测试一下:

# test_env.py
import sys
import git
print(f"Python 版本: {sys.version}")
print("Git 已就绪")
print("环境搭建完成!")

在终端里运行:

python test_env.py

如果一切正常,你会看到三行输出。嗯,到这里,你的开发环境就搭好了。

我的习惯:每次开始新项目,我都会先建一个虚拟环境,然后装好必要的包,最后把 requirements.txt 提交到 Git 里。这样不管换电脑还是换同事,都能秒级复现环境。

下一章,咱们开始写第一个多屏显示程序。准备好了吗?