用VSCode写Python:linter, formatter和debugger配置详解

夜宇大大_6142

夜宇大大_6142

2026-01-03

464人浏览

原创

VSCode Python开发需配置linter、formatter和debugger:用Pylint检测代码问题,Black或autopep8统一格式,debugpy调试普通脚本,Jupyter扩展支持notebook断点调试。

用vscode写python:linter, formatter和debugger配置详解

如果您在使用 VSCode 编写 Python 代码时发现代码无语法高亮提示、格式混乱或断点无法触发,可能是 linter、formatter 和 debugger 未正确配置。以下是针对这三类工具的详细配置步骤:

本文运行环境:MacBook Air,macOS Sequoia。

一、配置 Pylint 作为 linter

Pylint 是一个静态代码分析工具,用于检测代码中的错误、风格问题和潜在 bug,并提供可操作的错误码与修复建议。

1、在 VSCode 中打开命令面板(Cmd+Shift+P),输入并选择“Python: Select Linter”。

2、从列表中选择 Pylint。

3、若提示未安装,终端中执行 pip install pylint。

4、在工作区根目录创建 .pylintrc 文件,运行 pylint --generate-rcfile > .pylintrc。

5、在 VSCode 设置中搜索 “python.linting.pylintArgs”,添加自定义参数如 ["--rcfile=.pylintrc"]。

二、配置 Black 作为 formatter

Black 是一个无需配置的 Python 代码格式化器,强制统一代码风格,避免团队中因缩进、空格、换行引发的争议。

1、终端中执行 pip install black。

2、在 VSCode 设置中搜索 “python.formatting.provider”,将其值设为 black。

3、搜索 “editor.formatOnSave”,确保其值为 true。

4、如需自定义 line-length,创建 pyproject.toml 文件,在 [tool.black] 下添加 line-length = 88。

三、配置 autopep8 替代方案

当 Black 的严格格式限制影响开发节奏时,autopep8 提供更灵活的 PEP 8 兼容调整,支持仅修正选中行或文件。

1、终端中执行 pip install autopep8。

VSCode节点工具(专业版)
VSCode节点工具(专业版)

面向团队的企业级IDE远程操作平台,含调试、测试、终端、Agent委托与团队协作能力。

下载

2、VSCode 设置中将 “python.formatting.provider” 改为 autopep8。

3、在设置中添加 “python.formatting.autopep8Args”,填入 ["--in-place", "--aggressive"]。

4、保存时自动格式化仍由 “editor.formatOnSave” 控制,无需额外启用。

四、配置 Python 官方 debugger(ptvsd 已弃用,使用 debugpy)

debugpy 是微软官方维护的 Python 调试适配器,集成于 VSCode Python 扩展中,支持断点、变量监视、调用栈和 REPL 式调试控制台。

1、确认已安装 Python 扩展(Microsoft 发布,ID:ms-python.python)。

2、终端中执行 pip install debugpy。

3、在项目根目录创建 .vscode/launch.json,内容包含配置项 type: "python"、request: "launch"、module: "your_main_module"。

4、在代码行号左侧单击设置断点,按 Ctrl+F5 启动调试会话。

五、配置 Jupyter debugger(适用于 .ipynb 文件)

当在 VSCode 中直接编辑和运行 Jupyter Notebook 时,需启用内核级调试能力,使单元格内断点生效。

1、确保已安装 Python 扩展与 Jupyter 扩展(ID:ms-toolsai.jupyter)。

2、启动 notebook 后,点击右上角 kernel 选择器,确认内核状态为 Connected。

3、在任意代码单元格中点击行号左侧设置断点,运行该单元格。

4、调试控制台将输出变量值与异常堆栈,支持 Step Over / Step Into 操作。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2375

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3942

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1296

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4559

7

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

3690

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

8363

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

10102

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

5347

16

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

7167

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程