硬核教程：五步掌握用VSCode进行高效Python开发

原创量子位 2019-09-23 12:06:42

轻沉发自浅度寺

量子位出品 | 公众号 QbitAI

在程序员圈子里，Visual Studio Code（以下简称VSCode）可以说是目前最火的代码编辑器之一了。

它是微软出品的一款可扩展的轻量级开源编辑器，并且支持全平台系统。这些特性使得VSCode颇受欢迎，这也使其成为了一个很棒的Python开发平台。

在本文中，你将学到如何在VSCode中进行高效的Python开发，其中包括：

安装VSCode
安装插件让Python开发更便利
编写一个简单的Python应用
学习如何在VSCode中运行和调试已有的Python程序
在VSCode中使用Git和Github来管理代码

本文假设你已经熟悉了基本的Python开发，并且计算机上安装了某个版本的Python（Python2.7、Python3.6/7、Anaconda等）。

文中会提供Ubuntu和Windows系统上的运行截图和样例，但由于VSCode还可以在其他主流平台上运行，所以你可能会在实际操作中看到略微有些差异的UI界面，一些命令的键位可能也需要修改。

VSCode的安装与配置

在任何平台上安装VSCode都不是难事。微软提供了Windows，Mac和Linux平台上详尽的安装指引，并且每月都会有更新以推出新特性或修复已知问题。

这些都可以在VSCode官网上找到：

https://code.visualstudio.com

可能你会想，VSCode和那个庞大的Visual Studio名字这么像，它们会不会有什么关系呢？但其实，并没有，哈哈。

VSCode默认支持多种编程语言，并且有着丰富的扩展。VSCode每月更新，你可以在微软博客上随时关注更新的进展。微软甚至把代码开源在了Github上供所有开发者克隆仓库甚至贡献代码（暗示大家赶紧来提PR）。

VSCode的用户界面官方给出了详细的操作说明，如下图所示，在此不再赘述。

为Python开发安装插件

正如上文中提到，VSCode可以通过自身良好的扩展性质来支持各种编程语言的开发。

Python插件使我们可以更方便地在VSCode中进行Python开发，它有以下功能和特点：

支持Python2.7和Python3.4+的Pyhon版本
使用IntelliSense进行代码补全
代码检查器
对调试的支持
代码段功能
对单元测试的支持
自动应用虚拟环境
可在Jupyter环境和Jupyter Notebook中编辑代码

事实上，VSCode插件并不仅是编程语言层面的，如下面这些：Keymaps可以改变VSCode的操作方式，让那些习惯使用Atom，Sublime Text，Emacs，Vim，Pycharm等其他编辑器的开发者更舒服。

Themes可以定制用户界面外观，不管你是喜欢亮色、暗色或五彩斑斓的黑，它都能满足；Language提供了良好的本地化体验。

还有一些很有用的插件推荐给大家：

GitLens提供了许多可以直接在编辑窗口中使用的Git特性，包括blame标注和仓库探索等；
Autosave可以通过菜单栏File—Auto Save开启，顾名思义，它会以固定的时间间隔保存你的代码，默认是1000毫秒（1秒），这个值是可以配置的；
Settings Sync可以让你通过Github在多个VSCode安装中同步配置，如果你会在不同的机器上使用VSCode，这么做可以让你保持开发环境的一致性；
Docker插件可以当让你愉快地使用Docker工作，它帮助开发者编写dockerfile和docker-compose.yml，打包并部署项目，甚至为项目自动生成dockerfile。

当然了，你也可以自己发掘其他有趣有用的插件，欢迎和大家分享你的发现！

可以通过点击左边活动栏的插件图标来进行插件或主题的发现和安装。你可以通过关键词来搜索插件，用多种方式排序搜索结果，并快捷方便地安装插件。

对于本文中使用到的Python插件，你可以搜索Python字样，然后在特定项上点击install进行安装。

同理，你可以用这种方式安装其他上面提到的插件。

VSCode配置文件

VSCode通过用户（user）和工作区（workspace）设置实现高度可配置化。

用户设置是应用于所有VSCode实例的全局性设置，而工作区设置是应用于特定文件夹或项目的局部设置。工作区设置给VSCode提供了极大的灵活性，我们在之后调出的都是工作区设置。

工作区设置以json格式保存在项目目录下.vscode文件夹中。

写个Python程序

让我们从一个Python程序开始探索如何在VSCode中进行Python开发。你可以在VSCode中使用快捷键Ctrl+N来编辑一个新文件（也可以在菜单栏中选择File—New File）。

Tips：VSCode用户界面提供了命令盘（command palette）功能，使你可以手不离键盘就能搜索、执行各项命令。按下Ctrl+Shift+P打开命令盘，键入new file，按下回车，也可以编辑一个新文件。

无论用哪种方法，你应该可以看到类似下面这样的窗口：

新文件打开后，就可以开始写代码啦。

我们快速写一个埃拉托斯特尼筛法（用来寻找不超过一个数的所有质数）作为测试代码。从下面这两行开始：

sieve = [True] * 101
for i in range(2, 100):

1 2	sieve = [True] * 101 for i in range(2, 100):

你应该看到类似下面的场景：

等等，发生什么了？为什么VSCode没有任何关键词高亮，格式自动调整等有用的东西？要它何用？

答案是，目前VSCode还不知道你在写什么。这个文字缓冲区叫做Untitled-1，如果你看看窗口右下角，你会发现写着Plain Text，也就是说VSCode还不知道你在写Python代码。

为了让Python插件发挥作用，我们需要将文件存储为后缀为py的文件，如sieve.py。你可以通过菜单栏File—Save File，或者按下Ctrl+S，或在命令盘键入save file来做到这一点。VSCode看到py后缀就会将文件解释为Python代码。现在你的窗口应该长这样：

好多了有没有！VSCode自动按照Python语言重新确定了格式，你可以在窗口左下角验证当前编程语言的正确性。

如果你同时安装了多个版本的Python（如Python2.7，Python3.x和Anaconda），你可以通过点击左下角的语言（这里的Python x.x.x）或在命令盘中选择select interpreter来切换Python解释器。VSCode默认用PEP8标准来格式化Python代码，但你也可以选用其他标准。

现在让我们完成剩余筛法代码。

为了能观察到IntelliSense发挥作用，请不要直接复制粘贴这段代码。亲手输入，你将看到下面的画面：

下面是埃拉托斯特尼筛法中“筛”这个部分的完整代码：

sieve = [True] * 101
for i in range(2, 100):
 if sieve[i]:
 print(i)
 for j in range(i*i, 100, i):
 sieve[j] = False

sieve = [True] * 101

for i in range(2, 100):

if sieve[i]:

print(i)

for j in range(i*i, 100, i):

sieve[j] = False

输入这段代码时，VSCode自动缩进了for和if下的语句，自动加上了结尾大括号，并为你提供输入建议。这就是IntelliSense的威力。

运行Python代码

既然写完了代码，我们就可以运行它了。因为VSCode可以直接在编辑器里运行代码，所以我们完全不需要离开编辑器。按Ctrl+S保存文件，接着在编辑器窗口中点击鼠标右键，选择Run Python File in Terminal。

可以看见，窗口下方出现了Terminal选项卡，显示了代码的输出。

对Python代码检查器的支持

你可能在写代码的时候看见过一个弹出框，上面写着代码检查器不可用（linting was not available）。你可以在弹出框中快速安装一个代码检查器，默认安装的是PyLint。VSCode也支持其他检查器，包括：flake8、mypy、pydocstyle、pep8、prospector、pyllama、bandit等。

Python代码检查器页面有配置每一种检查器的详细资料。注意，代码检查器的选择是项目级别的工作区设置，而不是全局用户设置。

编辑一个已有的Python项目

在埃拉托斯特尼筛法的例子中，你创建了一个单独的Python文件。这作为例子来讲很合适，但通常你会创建更大的项目，并在其上工作一段时间。一个典型的创建新项目的工作流程如下：

创建一个存放项目的文件夹（其中可能包含一个新的Github项目）
切换到新文件夹
用命令代码创建一个初始Python代码文件

在Python项目中使用VSCode会给你带来更多精彩的功能，让我们看看VSCode是怎样对付大型工程的。

早在上个世纪我还是一名年轻的程序员时，我用调度场算法写过一个将算式解析为中缀表达式的计算器程序。为了展示VSCode中项目专属的特性，我将算法重构成了Python的一个算式求值库：

https://github.com/JFincher42/PyEval

大家可以随意克隆至本地以进行后面的操作。

本地文件夹建好后，你可以通过VSCode快捷地打开整个文件夹，我比较喜欢下面这种方式：

cd /path/to/project
code .

1 2	cd /path/to/project code .

当这样打开时，VSCode将检测到并开启任何项目中存在的virtualenv、pipenv或conda虚拟环境，你甚至都不用自己手动去启动虚拟环境！以下几种方式都可以在用户界面中打开一个文件夹：菜单栏中点击File—Open Folder；按下快捷键Ctrl+K或Ctrl+O；在命令盘中键入file：open folder。

我的公式求值库项目打开后看起来是这样的：