开发套件安装与基本配置

VSCode在安装以后,并不能进行Python项目的开发,需要先进行配置。

首先要去扩展商店安装Python扩展。打开VSCode之后,进入扩展页面,在顶部的搜索栏中输入“Python”,即可搜索到由微软开发的Python扩展,安装之后即可为Visual Studio Code启用Python编辑功能。

接下来需要对Python进行一些配置。进入到配置编辑界面。VSCode的配置是由几个JSON文件组成的,其应用顺序是:默认配置\(\rightarrow\)用户配置\(\rightarrow\)工作区配置,后加载的配置内容会覆盖先加载的内容。VSCode的配置项非常多,不必要每项都十分了解,也不需要死记硬背。VSCode提供了自动将默认配置复制到用户配置和工作区配置的功能,并且在配置时大部分内容会给出可选项。在配置过程中要尽可能利用这一功能。

首先从默认配置复制files.exclude一项,在其中添加以下内容:**/*.pyc**/__pycache__。这是因为Python在执行时会将.py文件编译为.pyc的字节码文件,以加速脚本的执行,这些文件没有必要在编辑器的文件列表中保留。如果你还有想屏蔽的其他文件,也可以书写在这里。其中**表示任意深度的目录,*表示通配符。如果同时还会使用Jetbrains的PyCharm编辑器,那么还建议屏蔽掉**/.idea

之后找到python.pythonPath一项,将其复制到用户配置中,把Python3的可执行文件及其完整绝对路径填进去。但是注意,这里只是提供了一个用于运行virtualenv等非项目环境下功能的配置,在项目环境中,是不依靠这项配置的。如果使用的是Python的Anaconda或者Miniconda发行版的话,这里的设置会有一些区别,首先需要确定项目所使用的环境,其次要根据项目的特点选择合适的解释器,例如命令行程序可以使用python.exe解释器,GUI程序需要使用pythonw.exe解释器。

使用IDE的另一个需求是代码自动补全,这项功能是由Python库Jedi提供的,也可以安装辅助应用Kite来进行智能检索和提示。在一般情况下,Jedi已经足够使用。Jedi可以使用命令行pip install jedi完成安装,在VSCode的配置中配置python.jediPath一项,该项的配置内容是Jedi库所在的site-packages目录的绝对路径。Python发行版可以在安装目录的lib目录下找到,Anaconda发行版则需要到安装目录的lib/python3.x下寻找,具体目录位置是由Anaconda发行版所携带的Python版本决定的。

Tip

目前,微软已经为Visual Studio Code开发了新的Python支持插件:Pylance,并且已经默认启用,建议优先采用这个插件。

其他的内容诸如编辑器文字、主题、配色等配置,读者可以参考网上的其他VSCode配置教程,这里不再赘述。