从零开始，教你如何安装、配置Python开发环境以及VS code，超级详细！！！

近日，我鼓起勇气从头开始正儿八经地配置一个更轻量、更趁手的 Python 开发环境。经过一番折腾，我比较顺利地在 Windows 10 上配置了一个比较满意的 Python 环境：

• 安装稳定版本的 Python 3.7
• 使用微软出品的 VS Code 作为 IDE
• 使用 venv 模块为不同 Python 项目搭建相互隔离的运行环境
• 使用 Git 对 Python 项目进行版本管理
  本文就用大白话来介绍我的配置过程，对其中涉及的专业术语和操作加以解释，供自己日后复习查看，也希望能为准备尝试 Python 的新手朋友提供参考。

欢迎闲来无事的大小朋友们一起来玩 Python！

⚠️ 注：本文的操作在 Windows 10 上进行，但配置思路和所用软件均适用于 macOS。

安装 Python

在电脑上配置 Python 开发环境，第一件事当然是安装 Python 。安装 Python 就像安装一个其他软件一样：到 Python 官网上下载安装程序，然后安装到电脑上。

在 https://www.python.org，我们选择「Downloads——Windows」（根据你电脑的操作系统来选择），就可以来到供 Windows 操作系统使用的 Python 的下载页面。


▲ 在 Python 下载页面，每个版本都有对应的下载链接。

在这个页面，我们可以看到诸多的 Python 版本可供下载。这个时候，我们就迎来了一个关键的选择：选择哪个版本的 Python ？

Python 目前有两个大版本：Python 2 和 Python 3。Python 2 目前已经不再更新，最后一个版本是 Python 2.7.18；Python 3 是相较于 Python 2 有较大升级，不向下兼容，目前仍在持续更新中，最新版本是 Python 3.9.6。

「 Python 2 逐渐被淘汰，Python 3 当道」相信会是大势所趋。因此，如果没有特殊需求（比如你的项目需要用到的包不支持 Python 3 ），我们就选择安装 Python 3 了。

至于选择 Python 3 的哪个小版本，我的建议是选稳定的版本，而非最新的版本，以避免出现某些包还不支持最新版本 Python 导致的疑难杂症。我近日就有过一次血泪教训：我安装了最新的 Python 3.9.6，而在使用 pyinstaller 包将代码打包成 exe 程序的过程中总是出现缺失某个 dll 文件的警告，生成的 exe 程序到了别的电脑也无法正常运行。在苦苦折腾了一下午无果后，我卸载了 Python 3.9.6，安装了 Python 3.7.11，重新操作，一发就成功了。

以上就是我对选择 Python 版本的一些个人建议。决定好使用哪个版本的 Python 之后，我们在下载页面找到心仪版本，根据自己电脑是 32 位或 64 位下载相应的 Windows installer 或者 Windows executable installer 文件到电脑即可。

下载完成后，我们双击 exe 文件开始安装。安装时，我们可以选择「Install Now」来使用默认设置直接安装，也可以选择「Customize installation」来自定义安装目录和内容。请务必勾选「Add Python 3.7 to PATH」，也就是将 Python 添加至系统环境变量。这是一个很有用的操作，稍后会做详细介绍。

安装完成后，我们的电脑就可以「运行」Python 程序了。打开 Python 安装目录下的「python.exe」，在弹出的 Python 命令行窗口中输入 print(“Hello World”) 并按回车，我们就简单而仪式感拉满地运行了第一段 Python 代码啦。

▲ 第一段 Python 代码

当然了，我们不需要打开 python.exe 就可以运行 Python 程序。打开一个 Windows 终端，如 cmd 命令提示符窗口，输入 python 并按回车，窗口就会返回电脑上安装的 Python 版本信息，这时候我们已经进入 Python，接着输入 print(“Hello World”) 并按回车，就运行这段代码了。

▲ 从 Windows 终端进入 Python 并执行 Python 代码

我们也可以在 Windows 终端中使用指令 python Path\CodeName.py 来直接运行某一个后缀为「.py」的 Python 程序（或称为「脚本」）。

▲ 从 Windows 终端运行一个命名为「myPyCode.py」的 Python 程序

这要归功于我们在安装时「将 Python 添加至系统环境变量」的操作。「环境变量」的意义是：当我们要求系统运行一个程序而没有提供程序的完整路径时，系统除了在当前目录下面寻找此程序外，还会到「环境变量——Path」中指定的路径去寻找。我们将 Python 添加到系统环境变量，就可以让系统更快捷地找到并运行 Python，它的作用包括：

在终端中运行 Python 程序

使用 pip 安装或者离线安装 Python 包时找到 Python 的版本和路径

让某些 IDE 找到并调用 Python

因此，「将 Python 添加至系统环境变量」可以说是一个必要操作。如果安装时忘记勾选了也没有关系，我们稍费些功夫手动添加即可，手动添加的步骤可以参考这个链接：https://www.php.cn/python-tutorials-424800.html。

到目前为止，我们的电脑已经搭建起了简单的 Python 开发环境。但是它还很简陋，下一步我们利用各种工具就来让它变得更加好用。

使用 VS Code 开发 Python

上文多次提到 IDE，它的全称是「Integrated Development Environment」，中文称为「集成开发环境」，它是用于提供程序开发环境的应用程序，一般包括代码编辑器、编译器、调试器等，具有图形化用户界面。用大白话讲，IDE 就是一个让我们方便地写 Python 代码并运行和调试代码的软件。

目前用于开发 Python 的 IDE 有很多，我使用的是微软出品的 Visual Studio Code（简称 VS Code）。它功能和运行速度兼备，用起来十分舒服。

我们首先需要到 https://code.visualstudio.com 下载安装包并安装。

安装完成后运行 VS Code，这时候界面为英文。我们可以点击左侧边栏的 Extensions（拓展），搜索「Chinese」，就可以找到简体中文语言包拓展，点击「install」安装成功后重启软件，VS Code 现在就是中文界面了。

▲ 为 VS Code 安装简体中文语言包拓展

接下来，我们还需要在 VS Code 安装「Python」拓展，它才能运行和调试 Python 程序。搜索和安装「Python」拓展时请认准 Microsoft 出品的那个。

▲ 为 VS Code 安装「Python」拓展

安装完成后，我们点击「文件——新建文件」，VS Code 就会新建一个代码编辑窗口。点击第一行的「选择语言」，搜索并选择「Python」。由于是首次使用，此时 VS Code 会开始激活和加载「Python」拓展，完成后，左下角状态栏会显示我们电脑上所安装的 Python 版本3.7.9，这说明 VS Code 已经找到了我们所安装的 Python，并且会用它作为解释器来运行和调试 Python 程序。

我们在窗口中输入一些 Python 代码，由于安装了「Python」拓展，我们在输入代码时已经可以享受到代码着色、补全和智能提示等令人愉悦的功能了。

▲ 输入代码时的代码着色、补全和智能提示功能

代码编辑完成后，保存并点击右上角绿色三角形来运行。可以看到，VS Code 在编辑器下方打开了一个终端，并运行了我们的 Python 程序。

从终端所提供的信息，我们可以很清晰地看出在 VS Code 编辑和运行 Python 程序的逻辑：VS Code 提供编辑器让我们编辑代码；运行时，VS Code 找到并调用了我们安装在电脑上的 python.exe 作为解释器来运行我们的代码，并在终端中将运行结果打印出来。

现在，我们的 Python 开发环境开始好了起来，我们已经可以比较舒服地编辑 Python 代码、开发 Python 项目了。接下来，我们再来添加一些进阶的功能。

使用 Git 进行项目版本管理

在上文，我们采用「虚拟环境」来管理我们不同的 Python 项目，现在，我们来对每一个 Python 项目进行版本管理，让项目的程序文件可以被妥善、便捷地备份和恢复。所用到的工具是 Git。

▲ 使用 Git 备份和恢复 Python 项目

大名鼎鼎的 Git 是创建了 Linux 的 Linus 大神的作品，它是一个功能强大的分布式版本控制系统，可以实现代码版本回退、远程仓库、多人协作等功能。Git 的用法和功能很多，关于 Git 的详细操作，推荐大家参廖雪峰的 Git 教程（https://sspai.com/s/Oxx0）。在这里，我仅抛砖引玉地介绍 Git 的安装和基础功能。

安装 Git

使用 Git，要先安装 Git。在 Linux 或 MacOS 上的安装方法可以在 https://sspai.com/s/7yy8 找到。在 Windows 上，我们到 https://git-scm.com/downloads 下载安装程序并安装即可，安装目录可根据自己的喜好来，安装过程中有很多设置选项，作为新手，我们无脑下一步即可。安装完成之后，我们在安装目录或者开始菜单中找到「Git Bash.exe」，双击打开，看到一个命令行窗口，说明 Git 已经安装成功。

▲ Git Bash 命令行窗口

接着，我们在这个命令行窗口中输入以下指令来向 Git 声明我们的名字和 Email 地址：

> $ git config --global user.name "User Name"  
> $ git config --global user.email "email@example.com"

现在，我们电脑上的 Git 已经准备就绪，我们可以用它来对我们的 Python 项目进行版本管理了。使用 Git 进行版本管理的流程是十分清晰的：

• 创建 Git 版本库
• 在开发过程中随时向 Git 版本库提交程序文件
• 必要时从 Git 版本库恢复代码文件

创建 Git 版本库

首先，我们需要为我们的项目创建一个 Git 版本库（Repository）。仍以 myProject 这个项目为例，打开一个 Windows 终端，如 Powershell，执行cd D:\myProject指令进入到项目目录「D:\myProject」，然后执行git init指令。执行后，命令行窗口会提示创建了一个空的 Git 版本库，在「myProject」目录下可以看到一个新建的隐藏目录「.git」,目录里包含了版本库的所需文件。一个空的 Git 版本库就轻松创建完成。

▲ 成功创建一个空的版本库，「.git」目录里包含了版本库的所需文件。

提交文件到 Git 版本库

我们的「D:\myProject」项目目录下有两个Python程序文件 myCode1.py 和 myCode2.py。现在，我们来将它们提交到 Git 版本库中，让 Git 来记录和管理它们的内容变动。这需要两步操作：

• 第一步：在项目目录下执行git add
  myCode1.py指令来添加文件到版本库，其中myCode1.py为完整的文件名。我执行了两次git add指令来添加两个文件。
• 第二步：执行git commit -m "add 2 files."指令来完成本次提交，其中"add 2
  files."是对本次提交的注释，注意不要漏掉引号。

执行完成后，命令行窗口就会返回本次提交的文件改动数量和改动内容等信息。像下图，我们就成功向 Git 版本库提交了 myCode1.py 和 myCode2.py 两个文件。

▲ 将 myCode1.py 和 myCode2.py 提交到 Git 版本库

现在，我们可以执行一个指令git status来查看版本库的状态：

▲ Git status指令提示除了虚拟环境文件夹外，没有其他文件准备提交到版本库

从 Git 返回的信息来看，我们的虚拟环境文件夹没有提交到版本库，除此之外，我们的项目目录里没有准备提交的文件。

那么，现在我们来继续编辑我们的 Python 程序文件。myCode1.py 文件的代码内容如下，我们将最后一行代码print(‘‘Hello World!\n’’)注释掉，并添加一行代码print(‘‘Hello Git!\n’’)，然后保存：

> import numpy
> 
> print ("\\nThis is a Python Program\\n")
> 
> for i in numpy.arange(4):
> 
>     print (i)
> 
> \# print ('Hello World!\\n')
> 
> print ('Hello Git!\\n')

现在，在 Windows 终端里再次执行git status 指令看看结果：  

▲ Git status指令提示 myCode1.py 文件被修改了，修改内容未提交到版本库

可以看到，Git 提示我们，myCode1.py 文件在上一次提交到版本库之后被修改过了，修改内容还没有被提交到版本库。那么myCode1.py 具体被改动了什么呢？我们可以执行另一条指令git diff myCode1.py 来查看：

▲ Git diff指令提示 myCode1.py 文件详细的修改内容

可以看到，Git 可以不仅可以发现程序文件发生了修改，还可以知道具体的修改内容。事实上，Git 可以追踪各种文本文件的改动内容，包括 txt 文件、网页和各种程序代码等。而对于图片、视频、Microsoft Word 文件等二进制文件，Git 只能发现文件发生改动，但无法追踪具体的改动内容。

现在，我们就把修改后的 myCode1.py 再次提交给版本库吧。同样，执行 git add myCode1.py 指令来添加，但在执行提交指令 git commit 之前，先 git status 一下看看此时的状态：

▲ Git status指令提示 myCode1.py 文件准备提交到版本库

Git 提示我们：修改后的 myCode1.py 准备被提交到版本库。现在，我们就执行 git commit -m “modify the Hello info in myCode1” 来完成提交。

以上就是我们在项目开发过程中不断向 Git 版本库提交程序文件的一个缩影。在这个过程中，我们可以随时用 git status 和 git diff filename 来查看版本管理的状态。

当我们向 Git 版本库提交了很多次文件之后，我们可以执行 git log 指令来查看提交日志：

▲ 提交日志从最近到最远显示提交人员、日期和提交的注释

可以看到，提交日志忠诚地记录了我们项目的程序文件的每一次提交，提交日期和注释可以帮助我们记忆每次提交时的修改内容。这相当于我们的项目被妥善地「存盘」了。

从 Git 版本库恢复文件

版本管理的一个重要作用在于：我们把程序文件搞砸了之后，可以把文件恢复到某个历史版本，也就是「版本回退」。我们从 Git 版本库恢复上一版本文件的指令是 git reset --hard HEAD^，其中，HEAD 表示版本库最后一次提交的版本，而上一个版本是 HEAD^，再上一个版本就是 HEAD^^，往上 100 个版本可以写成 HEAD~100。

比如说，我执行了指令 git reset --hard HEAD^^，得到了以下结果：

▲ 执行了回退到上上个版本的指令后，Git 提示文件回到了「add 2 files」那个版本

打开两个程序文件看看，它们的确恢复到了「add 2 files」那一次提交时的状态的。

就这样，我们顺利地开始利用 Git 来对我们的项目进行版本管理了。不过，以上内容只是 Git 皮毛中的皮毛，更多的内容需要大家自行深入学习。

我们所使用的 VS Code 也为 Git 提供了 VIP 级别的可视化支持。我们电脑安装了 Git 之后，打开 VS Code ，点开左侧工具栏的「源代码管理」，就可以可视化地使用 Git 功能了。我们可以打开本地目录或者克隆版本库；如果打开的目录还没有 Git 版本库，VS Code 会提示我们进行初始化来新建 Git 版本库或者将文件夹发布到 GitHub；在一个配置了 Git 版本库的目录里，我们可以进行提交、推送、克隆等 Git 操作，相比于命令行指令，操作又更方便了一些啦。此外，我们还可以在 VS Code 中安装「Git」拓展来实现更完整的 Git 功能。

关于 VS Code 中的 Git 用法，推荐大家参考这篇文章：https://sspai.com/s/jNN0

▲ 在 VS Code 中的「源代码管理」中使用 Git

▲ 打开一个不包含版本库的目录时，VS Code 发出相关提示

▲ 在VS Code 中进行可视化 Git 操作

现在，我们的项目目录里有「virtualEnvironment」目录和「.git」目录，它们是我们管理 Python 项目的两个利器：虚拟环境和 Git 。有两个利器在手，我们的 Python 项目开发环境就非常清晰和舒服了。

尾声

看到这里，大家辛苦了。以上就是我在电脑上搭建 Python 开发环境的讲解。本人才疏学浅，在 Python 开发上只是一名半路出家的门外汉，文中（尤其是虚拟环境和 Git 的使用部分）的不足和错误在所难免，请大牛轻喷，欢迎评论交流。