从0开始深度学习工程师之路（三）：Python开发环境搭建（VSCode）

在python开发之远程开发工具选择_CodingInCV的博客-CSDN博客和 从0开始全栈深度学习工程师之路（二）：开发的基础设施和工具之语言和开发工具_CodingInCV的博客-CSDN博客 中，我们已经对Python的开发工具进行了一些对比，本章则进入实战，开始搭建自己的Python开发环境。由于我日常会设计要到不同的服务器进行远程开发，VSCode相对更方便且免费，所以我的Python开发环境从以前的Pycharm社区版切换到了VSCode, 后面此文也就以VSCode作为开发工具了, 后面如果有时间会再写一篇Pycharm的配置，大同小异，对于Python的开发，2者都挺不错。

Python安装

进行Python安装当然首先需要安装Python了，对于不同平台有不同的安装方式。比如windows可以从microsoft store安装，linux可以在命令行安装。不过本文不准备用这些方式了，而是使用更通用的方式，也是实际开发中会用到的包管理器 conda。

conda分为miniconda和anaconda，二者的区别就是miniconda体积小，只包含了Python解释器和conda的一些命令，而anaconda则集成了常用的包，比如numpy，scipy等，以及jupyter lab/notebook等工具，体积更大，可以按需选择。这里使用miniconda，当需要使用其他包时，我们自行安装。

miniconda3下载

Miniconda — conda documentation
)

根据自己的操作系统选择安装包以及默认的Python版本，一般而言，不选最新的Python版本，以免优先三方库还没有适配，这里选择Python3.9。
对于Windows系统，点击安装包即可

为了使用方便这里我们勾选将miniconda3加入到环境变量中。如果安装的时候忘了选，也可以手动将miniconda3的安装目录，以及其中condabin和Scripts目录加入环境变量中。

对于linux系统
直接在命令行运行下载的安装包

验证安装结果

打开终端，输入“python”, 若安装成功，应输出python版本信息,否则检查是否环境变量设置有问题：

安装第三方包

有两种方式，一种是conda install, 一种是pip install，大部分情况下我们可以使用pip install，有些时候conda install会提供一些更高性能编译的包，比如numpy, conda安装的是以mkl为后端，而pip install为openblas。
打开终端，输入pip install package_name即可

VSCode安装与配置

VSCode下载与安装

Download Visual Studio Code - Mac, Linux, Windows
根据操作系统选择

这里我们选择User Installer x64。下载后，根据提示安装即可。
大概熟悉一下VSCode的界面：

总体上分为几个区域：
菜单栏：最上面一排，基本上所有软件都这样，也没什么特别的
功能选择条：官方叫Activity Bar，在最左侧一条，当我们安装某些插件后，也会在左侧有图标。VSCode自带的从上打下是文件浏览、查找、Git、调试器、远程管理、插件市场
侧边栏：根据选择的不同功能，这个区域显示的不同，比如我们选择最上面的文件浏览功能，这个区域就显示我们打开的文件或文件夹。
代码编辑区：右侧的大片区域是代码编辑区域。
状态条：最下面一条是状态条，一些运行状态在这里显示。

Python相关插件安装

开发python必要的插件是Python和Pylance，均是微软官方出品。其他有助于我们开发的插件在后续使用中逐步添加，目前我们只需要这2个插件(对于需要中文版本的VScode的，在插件市场搜索“中文”，选择安装简体中文汉化包)。
打开插件市场，搜索安装这2个插件，或者新建一个.py文件，右下角会有提示安装这2个插件。

Python解释器配置

新建打开已有的Python项目，右下角将会出现当前Python解释器，当有多个解释器版本时，我们可以点击选择：

调试配置

接下来我们建立我们的第一个python项目，并且打断点调试。
手动建立hello_world文件夹或者点击“add a folder”, 若是手动建立的文件夹，则选择"Open Folder"，选择我们建立的文件夹。

“Ctrl+N”或在侧边栏右键或点击侧边栏中的新建文件图标，建立我们的第一个文件：

"F5"或菜单栏Run->Start Debuging, 选择Python File：

在编辑器下方的terminal区域，将出现我们程序的运行结果：

断点调试

在我们需要打断点的代码行，点击“F9”，将在行前出现红点:

“F5”开始调试，程序将在端点处暂停：

运行中的变量显示在侧边栏。
F5可继续运行，F10执行当前行，F11进入函数。

调试/运行设置

上面的调试我们是以默认方式进行的，实际上先cd到了项目目录，然后执行了python 当前文件绝对路径，不一定符合我们的调试需要，这个可以从terminal窗口看到：

有些时候我们还需要传入启动参数、环境变量等，默认的方式就不够了，这时我们就需要修改配置了。VSCode中的调试配置是通过一个叫launch.json的文件控制（还有一个task.json，暂时用不上，先略过）。
Run->Add Configuration 添加一个调试配置文件

默认的配置是：

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "justMyCode": true,
        }
    ]
}

若要添加命令行参数，新增args:

            "args": [

            ]

若要添加环境变量，新增env:

"env": {
                "PYTHONPATH": "${workspaceFolder}"
            }

默认justMyCode是true，表示只调试自己写的代码，而不进入第三方包，如果需要，则改为false.
默认情况下，工作目录是当前项目目录，执行的是当前文件的绝对路径。如果要改变，可以设置cwd和program:
如下面将工作目录设置到了当前文件的目录，按文件的相对路径执行。这些主要影响的是我们程序中与文件路径相关的一些参数。比如我们的文件中打开一个文件，路径都是相对cwd来的。

"cwd": "${fileDirname}}",
"program": "${relativeFile}",

VSCode定义了很多宏，比如我们配置的fileDirname，在设置的时候会自动补全，还是比较方便的。
设置好launch.json后，其他调试步骤与前文一致。

结语

到这里，我们的一个基本的开发环境就配好了，已经可以进行python开发和调试了。VSCode还有一些其他插件和设置有利于我们更好的开发，会在下一篇介绍。