如何配置 VSCode 编写运行 Python 代码
阅读 8:03·字数 2420·更新
Youtube 频道
Bilibili 空间
关注 1421
关注 1421
前提
在开始本节内容之前，请确保 Python 已被正确安装，你可以查看如何在 UNIX/Linux/Windows/macOS 中安装 Python一节来获取相关信息。
如何在 VSCode 中搭建 Python 开发环境视频演示 YouTube如何在 VSCode 中搭建 Python 开发环境视频演示 Bilibili
VSCode 如何搭建 Python 开发环境？运行 Python 代码｜编程教程视频演示 Bilibili
安装 VSCode
VSCode（Visual Studio Code，VS Code）是一款强大有效的开发工具，通过安装相关的扩展，他可以支持多种语言代码的编写和调试，包括 Python 在内。
官方网站提供了不同版本的安装包和压缩包，以便开发人员可以在 Linux/Windows/macOS 上轻松使用 VSCode。你可以根据自己的需要，下载对应的安装包或压缩包，安装的过程较为简单，这里略过。
安装 VSCode 扩展 Python
要想在 VSCode 中运行和调试 Python 代码，你可以选择安装由微软开发的 VSCode 扩展Python（ms-python.python），他提供了 Python 开发所需的常用功能。该扩展可通过扩展面板的搜索功能找到，你需要根据情况选择安装或启用他，如果已处于启用状态则无需任何操作。
由于扩展包的存在，安装扩展Python还将一同安装扩展Pylance和扩展Python Debugger。
如何配置 VSCode 所使用的 Python 解释器版本？
如果你拥有多个版本的 Python，那么可通过以下方式选择其中一个作为 VSCode 的 Python 解释器。
使用命令面板的键盘快捷方式（Linux/Windows 中默认为Ctrl+Shift+P，macOS 中默认为⇧+⌘+P）打开 VSCode 的命令面板，输入并执行命令Python: Select Interpreter，即可添加和选择某个版本的 Python 解释器。
扩展 Python 需要其他扩展来实现更多功能
由于扩展Python并不具备某些功能的具体实现，因此还需要继续安装一些其他的扩展。比如，你可以安装实现代码智能提示和补全的Pylance，实现调试功能的Python Debugger，实现代码格式化的autopep8，Black Formatter，实现代码纠错和质量检查的Pylint，Flake8。
以上这些扩展的安装方法与扩展Python类似，部分扩展可能需要重新启动 VSCode 才能生效。
安装 VSCode 扩展 Pylance
扩展Pylance（ms-python.vscode-pylance）提供了 Python 代码的诊断分析，智能提示和补全等功能，他会跟随扩展Python一同被安装，是扩展Python所选择的默认语言服务器。
如何为 VSCode 指定默认的 Python 语言服务器？
你可以通过修改 VSCode 的设置项python.languageServer，来指定默认的 Python 语言服务器，当然，在本节中我们应该将其设置为Default或Pylance，以确保扩展Pylance被采用。要完成以上目标，需要在设置面板中搜索@id:python.languageServer，或直接编辑settings.json文件。
Pylance 使用和设置说明
想要详细了解扩展Pylance的使用和设置，你可以查看VSCode Pylance 扩展的使用和设置说明一节。
安装 VSCode 扩展 Python Debugger
扩展Python Debugger（ms-python.debugpy）提供了调试 Python 代码的功能。在安装并启用该扩展之后，你可以通过编辑器右上角的运行/调试按钮（点击箭头按钮进行选择），调试 Python 脚本。
安装 VSCode 扩展 autopep8，Black Formatter
扩展autopep8（ms-python.autopep8），Black Formatter（ms-python.black-formatter）提供了 Python 代码的格式化功能。
如何为 VSCode 指定默认的 Python 格式化程序？
当你同时启用了扩展autopep8和Black Formatter，并且尚未指定默认的格式化程序时，VSCode 会在适当的时机要求你做出选择，这些选择可通过在设置面板中搜索@lang:python editor.defaultFormatter，或编辑settings.json文件进行修改，如果是编辑settings.json，那么editor.defaultFormatter设置项应被设置为ms-python.autopep8或ms-python.black-formatter。
autopep8 使用和设置说明
想要详细了解扩展autopep8的使用和设置，你可以查看VSCode autopep8 扩展的使用和设置说明一节。
安装 VSCode 扩展 Pylint，Flake8
扩展Pylint（ms-python.pylint），Flake8（ms-python.flake8）提供了 Python 代码的纠错和质量检查功能。他们会检查已经打开的 Python 脚本文件，并将检查结果反馈给开发人员。
在 VSCode 中编写 Python 代码
在相关扩展准备完毕后，你可以在 VSCode 中打开任意一个文件夹作为工作区，如果被询问是否信任此文件夹中的文件的作者？，选择是，我信任此作者。
在资源管理器面板中新建任意一个扩展名为py的 Python 脚本文件，比如hello_world.py。在该文件中书写代码，调用print函数显示欢迎信息，相关的扩展会有所响应，比如，显示print函数的使用说明。
print('你好，Python！')在 VSCode 中运行 Python 代码
VSCode 为我们提供了多种运行或调试 Python 代码的方法。
比如，点击代码窗口中的运行/调试按钮（调试需要安装并启用扩展Python Debugger），将运行或调试当前窗口对应的 Python 脚本文件。或者打开运行和调试面板，点击创建 launch.json 文件并选择 Python Debugger | Python 文件（如果需要的话），这将在launch.json文件中添加用于运行调试当前脚本文件的配置，此时，按下F5即可运行调试当前活动的脚本文件。
如果launch.json文件不存在或该文件中没有相关的配置，则按下F5后，需要选择一个可用的配置以启动运行或调试。
你好，Python！内容分类
源码
讲解视频
如何在 VSCode 中搭建 Python 开发环境·YouTube如何在 VSCode 中搭建 Python 开发环境·Bilibili
VSCode 如何搭建 Python 开发环境？运行 Python 代码｜编程教程·Bilibili