简介这份PDF资料面向使用VSCode进行Python开发的程序员尤其是希望把编辑器打造成高效IDE的初学者与进阶者。内容围绕微软官方MS Python插件展开系统梳理了静态代码扫描、智能提示与自动补全、自动缩进、代码格式化、代码重构、引用查看与代码导航、SSH远程调试与多线程调试、单元测试运行、终端执行代码片段等核心能力并补充了Guides缩进提示、vscode-icons图标集、调试自动暂停配置以及autopep8、yapf、pylint-django、flake8等配套插件的安装与使用要点。资源为1个PDF文件压缩包约144KB轻量易读适合随时查阅。目前已有2185人学习下载读者可据此快速完成插件选型与个性化配置掌握自定义Snippets、代码风格统一和调试排错思路让VSCode更贴合个人开发习惯。1. 从一台裸机 VSCode 到顺手的 Python 工作台我踩过的插件配置路线刚装完 VSCode 的人打开一个.py文件大概率是懵的没有补全、没有报错提示、点运行没反应甚至连解释器在哪都要自己找。这不是 VSCode 不好用而是它出厂就是个「空壳编辑器」Python 能力几乎全靠插件和配置堆出来。这篇讲的就是把 VSCode 从裸机状态配成一套能写脚本、能跑爬虫、能做量化策略回测、能调试多文件项目的 Python 工作台。适合两类人刚跟着 python 安装教程装完环境、准备用 VSCode 入门的新手以及用了一阵子但补全慢、调试老断、格式化总打架、想系统梳理一遍配置的老手。核心就三件事装哪些插件、每个插件的关键参数怎么设、插件之间冲突了怎么排。下面按「先跑通最小闭环再逐个加能力」的顺序讲每一步都能直接抄。2. 最小可用闭环Python 扩展 解释器选择 首次运行2.1 为什么第一个装的必须是 Python 扩展而不是别的VSCode 本身不认识 Python它只认识「语言服务器」这个概念。微软官方的 Python 扩展扩展 IDms-python.python做的事情是把 Pylance语言服务器、调试器 debugpy、测试框架适配、环境发现这几块打包在一起。你装完它补全、跳转、类型提示、调试、运行按钮才会一起出现。很多人一上来先装一堆花哨插件结果补全还是不动就是因为底座没装。装的方式有两种图形界面里搜「Python」认准发布者是 Microsoft或者命令行直接装适合批量配置新机器# 列出当前已装扩展确认环境干净 code --list-extensions # 装 Python 扩展含 Pylance 依赖 code --install-extension ms-python.python # 单独确认 Pylance 在不在它是补全和类型检查的核心 code --install-extension ms-python.vscode-pylance逻辑说明code --install-extension是 VSCode CLI 的装扩展命令扩展 ID 用发布者.扩展名格式。参数上没什么可调的关键是认准 ID别装到同名的第三方仿冒扩展。装完重启一次窗口CtrlShiftP输入Reload Window让语言服务器加载。2.2 解释器选不对后面全是玄学Python 扩展装完第一件事不是写代码是选解释器。VSCode 允许一台机器上有多个 Python系统自带、python.org 安装的、conda 环境、venv 虚拟环境它默认可能挑了个你没装库的那个于是import requests报红、运行报 ModuleNotFoundError新手最容易在这里翻车。操作路径CtrlShiftP→ 输入Python: Select Interpreter→ 从列表里选。列表里带(venv: venv)或conda标注的就是虚拟环境优先选项目自己的虚拟环境别选全局的。选完会在项目根目录生成.vscode/settings.json内容类似{ python.defaultInterpreterPath: D:/projects/demo/.venv/Scripts/python.exe, python.terminal.activateEnvironment: true }参数说明python.defaultInterpreterPath是工作区默认解释器路径Windows 指向Scripts/python.exeLinux/macOS 指向bin/pythonpython.terminal.activateEnvironment设为 true 后你在 VSCode 里开终端会自动激活对应虚拟环境省得每次手动source activate。这两个参数是整个配置的地基后面所有插件都读它。2.3 跑通第一个文件确认闭环成立新建hello.py写两行点右上角三角运行import sys print(sys.executable) # 打印当前用的解释器验证选对了没 print(hello vscode)如果输出的解释器路径和你选的一致最小闭环就成了。这一步看着简单但它同时验证了三件事解释器选对、终端能激活环境、运行按钮接的是正确解释器。后面所有问题排查都先回到这一步确认地基没歪。常见做法是把这个文件留在项目里当「体检脚本」换机器、换环境时先跑一遍。3. 补全与类型检查Pylance 的 4 个必调参数3.1 Pylance 和 Python 扩展是什么关系Pylance 是独立的语言服务器扩展Python 扩展会把它作为依赖自动装上。它负责补全、跳转定义、查找引用、类型推断、内联提示。很多人以为补全慢是 VSCode 卡其实是 Pylance 在扫整个项目或者索引了不该索引的目录。它的行为几乎全在settings.json里控制调对了体验差别巨大。3.2 四个真正影响手感的参数{ python.analysis.typeCheckingMode: basic, python.analysis.autoImportCompletions: true, python.analysis.indexing: true, python.analysis.diagnosticSeverityOverrides: { reportMissingImports: warning } }参数说明逐个讲typeCheckingMode有三个档off、basic、strict。新手用basic它会提示明显的类型错误但不烦人strict会把每个没标注类型的函数都标黄写脚本时噪音太大除非你在维护大型库。我一般项目初期用 basic核心模块稳定后再局部开 strict。autoImportCompletions设为 true 后你打DataFrame它会自动补from pandas import DataFrame这是省时间的大头必开。indexing控制是否对第三方库建索引。开了补全能进库内部但首次打开大项目会卡几十秒建索引。项目小就开机器内存紧张或者库特别多可以关掉换启动速度。diagnosticSeverityOverrides用来压掉误报。比如某些动态导入的库 Pylance 找不到reportMissingImports默认是 error 会满屏红改成 warning 眼不见心不烦但别改成 none那样真丢了依赖你也看不见。3.3 什么时候该关掉 Pylance 的某些检查写爬虫、量化策略这类大量用动态属性、getattr、第三方 C 扩展的场景Pylance 会误报一堆「属性不存在」。这时候不是关掉整个 Pylance而是按文件或按规则压{ python.analysis.diagnosticSeverityOverrides: { reportAttributeAccessIssue: none, reportGeneralTypeIssues: warning } }逻辑是reportAttributeAccessIssue对应「对象没有这个属性」的报错动态场景误报最多直接关reportGeneralTypeIssues保留 warning 级别真出问题还能瞄一眼。这种按规则粒度压报错比整个关掉类型检查理性得多也是老手和新手配置的分水岭。4. 格式化与 lintBlack、Ruff、isort 怎么分工不打架4.1 三个工具各管什么别让它们抢活格式化这块最常见的翻车是装了 Black 又装了 autopep8保存时两个都触发代码被来回改。正确分工是——Black 管代码风格缩进、引号、换行isort 管 import 排序Ruff 管 lint未使用变量、未定义名、复杂度。Ruff 现在也能兼做 isort 的活所以更省事的组合是 Black Ruff。pip install black ruff{ editor.formatOnSave: true, editor.defaultFormatter: charliermarsh.ruff, [python]: { editor.defaultFormatter: ms-python.black-formatter, editor.codeActionsOnSave: { source.organizeImports: explicit } } }参数说明editor.defaultFormatter全局设一个再用[python]块覆盖成 Python 专用避免影响你写 JSON、Markdown 的格式化。source.organizeImports设为explicit表示保存时自动整理 import值用explicit而不是true是较新版本的写法老版本写true也行。formatOnSave是总开关不想每次保存都格式化就设 false改成手动ShiftAltF。4.2 Ruff 的配置放哪、怎么配Ruff 支持在pyproject.toml里配比散在 settings.json 里更工程化[tool.ruff] line-length 100 target-version py311 [tool.ruff.lint] select [E, F, I, UP] ignore [E501]参数说明line-length要和 Black 保持一致否则两个工具对同一行是否超长判断不同会互相打架这是血泪经验。select里E/F是 pycodestyle 和 pyflakes 规则I是 import 排序UP是 pyupgrade 现代化建议。ignore掉E501行太长是因为 Black 已经管了换行Ruff 再报一次纯属重复。4.3 保存时到底触发了什么出问题看哪保存一个文件时VSCode 按顺序做先跑 code action整理 import→ 再跑 formatterBlack 格式化→ 最后 Ruff 报 lint。如果发现保存后代码没变先看右下角状态栏有没有格式化器名字没有说明defaultFormatter没生效如果代码被改乱了多半是两个 formatter 同时开着。排查顺序永远是确认只有一个 formatter、确认 line-length 一致、确认 Ruff 和 Black 没同时管换行。5. 调试与运行配置launch.json 里真正要改的字段5.1 为什么点运行能跑调试却断不下来运行按钮走的是「在终端跑 python 文件」调试走的是 debugpy 注入。两者配置是分开的。默认调试配置能应付单文件但一旦涉及传参、指定工作目录、多文件入口就得自己写launch.json。位置在.vscode/launch.json。{ version: 0.2.0, configurations: [ { name: Python: 当前文件, type: debugpy, request: launch, program: ${file}, console: integratedTerminal, cwd: ${workspaceFolder}, args: [--input, data.csv], env: { PYTHONPATH: ${workspaceFolder} } } ] }参数说明type现在用debugpy老配置写python也能兼容但会提示迁移。program用${file}表示调试当前打开的文件改成固定路径就调试指定入口。console设integratedTerminal让程序在集成终端跑能接受 input() 输入设成internalConsole就没法交互这是新手调试爬虫时卡住的常见原因。cwd是工作目录读相对路径文件全靠它。args传命令行参数。env里设PYTHONPATH解决「模块找不到」的导入问题比在每个文件里sys.path.append干净。5.2 断点不生效的三个原因断点是灰的、打不上或者打上了不停通常是解释器选错调试器注入到了另一个 Python、文件没保存debugpy 跑的是磁盘上的旧版本、代码走了多进程子进程默认不继承调试器。前两个改配置就行第三个要在 launch.json 里加subProcess: true才能调试子进程写多进程爬虫、量化回测并行时必加。5.3 条件断点和日志断点比 print 高效在断点上右键可以设条件比如i 100才停和日志消息打印变量但不暂停。调循环里的 bug 时条件断点能让你直接跳到出问题那一次迭代比满屏 print 强太多。日志断点适合「我只想看值不想停」的场景输出到调试控制台不污染代码。6. 避坑与排查插件配置里最容易翻车的 5 件事6.1 补全突然全没了只剩纯文本现象打开 py 文件补全、跳转、报错全消失状态栏显示语言模式是 Plain Text。原因VSCode 没把这个文件识别成 Python常见于文件没保存、后缀不对或者 Python 扩展崩了。解决点右下角语言模式切回 Python不行就CtrlShiftP跑Developer: Reload Window再不行看输出面板里 Python 和 Pylance 的日志有没有报错。6.2 保存时格式化把代码改乱现象每次保存引号、缩进、import 顺序都在变甚至两个工具来回改。原因装了多个 formatter 且都开着或者 Black 和 Ruff 的 line-length 不一致。解决settings.json里只留一个defaultFormatter把 autopep8、yapf 这类卸掉或禁用统一 line-length。6.3 调试时 ModuleNotFoundError但终端里能跑现象终端python main.py正常F5 调试就找不到模块。原因调试器的工作目录或 PYTHONPATH 和终端不一致。解决launch.json 里显式设cwd为${workspaceFolder}env里加PYTHONPATH确认调试用的解释器和终端是同一个。6.4 大项目打开后 Pylance 一直转圈、内存飙升现象打开含大量第三方库或数据文件的项目Pylance 索引卡死。原因它把不该索引的目录数据集、node_modules、build 产物也扫了。解决在 settings.json 里配python.analysis.exclude和files.exclude把数据目录、虚拟环境目录排除掉。{ python.analysis.exclude: [**/data/**, **/build/**, **/.venv/**], files.watcherExclude: { **/.venv/**: true, **/data/**: true } }6.5 虚拟环境装了库VSCode 还是报找不到现象pip install明明成功import 还是红。原因pip 装到了另一个 Python或者 VSCode 选的是全局解释器。解决在 VSCode 集成终端里跑python -m pip install xxx保证 pip 和当前解释器绑定再用Python: Select Interpreter确认选的是同一个环境。养成用python -m pip而不是裸pip的习惯能避开一大半环境错乱。7. 进阶用 settings.json 分层 多环境切换把配置变成可复用资产配置写到后面你会发现真正省事的不是装了多少插件而是把配置分层管理。VSCode 的 settings 有三个层级优先级从低到高用户级全局所有项目共享、工作区级.vscode/settings.json跟项目走、文件夹级多根工作区用。我的习惯是用户级只放和项目无关的通用项字体、主题、formatOnSave总开关工作区级放和这个项目强相关的解释器路径、lint 规则、exclude 目录。这样换项目时通用手感不变项目专属配置跟着仓库走团队里别人 clone 下来直接就是一套配好的环境。多环境切换是另一个高频需求。同一台机器上跑爬虫用一套依赖、跑量化回测用另一套靠虚拟环境隔离靠Python: Select Interpreter切换。切完记得看一眼终端有没有重新激活没激活就手动deactivate再激活。下面这张表是我常用的插件清单和它们各自负责的环节按需装别一次全上插件扩展 ID负责环节是否必装Pythonms-python.python解释器、调试、运行必装Pylancems-python.vscode-pylance补全、类型检查必装Black Formatterms-python.black-formatter代码格式化推荐Ruffcharliermarsh.rufflint import 排序推荐Jupyterms-toolsai.jupyternotebook、数据分析按需Even Better TOMLtamasfe.even-better-toml编辑 pyproject.toml按需最后说一个验证配置是否真的生效的技巧改完 settings.json 不要凭感觉打开命令面板跑Developer: Inspect Editor Tokens and Scopes看语言模式跑Python: Show Output看语言服务器日志跑一次格式化看右下角格式化器名字。配置这东西看得见才算数。我自己这些年最大的教训是别追求一次配到完美先把「解释器 Python 扩展 一个 formatter」这三样跑通用一周缺什么补什么。一上来照着别人的插件清单全装一遍最后大概率是插件互相打架你还不知道是哪个的锅。配置是长出来的不是抄出来的。希望帮到你。本文还有配套的精品资源点击获取 VSCode Python 工作台配置指南：插件、调试与避坑
简介这份PDF资料面向使用VSCode进行Python开发的程序员尤其是希望把编辑器打造成高效IDE的初学者与进阶者。内容围绕微软官方MS Python插件展开系统梳理了静态代码扫描、智能提示与自动补全、自动缩进、代码格式化、代码重构、引用查看与代码导航、SSH远程调试与多线程调试、单元测试运行、终端执行代码片段等核心能力并补充了Guides缩进提示、vscode-icons图标集、调试自动暂停配置以及autopep8、yapf、pylint-django、flake8等配套插件的安装与使用要点。资源为1个PDF文件压缩包约144KB轻量易读适合随时查阅。目前已有2185人学习下载读者可据此快速完成插件选型与个性化配置掌握自定义Snippets、代码风格统一和调试排错思路让VSCode更贴合个人开发习惯。1. 从一台裸机 VSCode 到顺手的 Python 工作台我踩过的插件配置路线刚装完 VSCode 的人打开一个.py文件大概率是懵的没有补全、没有报错提示、点运行没反应甚至连解释器在哪都要自己找。这不是 VSCode 不好用而是它出厂就是个「空壳编辑器」Python 能力几乎全靠插件和配置堆出来。这篇讲的就是把 VSCode 从裸机状态配成一套能写脚本、能跑爬虫、能做量化策略回测、能调试多文件项目的 Python 工作台。适合两类人刚跟着 python 安装教程装完环境、准备用 VSCode 入门的新手以及用了一阵子但补全慢、调试老断、格式化总打架、想系统梳理一遍配置的老手。核心就三件事装哪些插件、每个插件的关键参数怎么设、插件之间冲突了怎么排。下面按「先跑通最小闭环再逐个加能力」的顺序讲每一步都能直接抄。2. 最小可用闭环Python 扩展 解释器选择 首次运行2.1 为什么第一个装的必须是 Python 扩展而不是别的VSCode 本身不认识 Python它只认识「语言服务器」这个概念。微软官方的 Python 扩展扩展 IDms-python.python做的事情是把 Pylance语言服务器、调试器 debugpy、测试框架适配、环境发现这几块打包在一起。你装完它补全、跳转、类型提示、调试、运行按钮才会一起出现。很多人一上来先装一堆花哨插件结果补全还是不动就是因为底座没装。装的方式有两种图形界面里搜「Python」认准发布者是 Microsoft或者命令行直接装适合批量配置新机器# 列出当前已装扩展确认环境干净 code --list-extensions # 装 Python 扩展含 Pylance 依赖 code --install-extension ms-python.python # 单独确认 Pylance 在不在它是补全和类型检查的核心 code --install-extension ms-python.vscode-pylance逻辑说明code --install-extension是 VSCode CLI 的装扩展命令扩展 ID 用发布者.扩展名格式。参数上没什么可调的关键是认准 ID别装到同名的第三方仿冒扩展。装完重启一次窗口CtrlShiftP输入Reload Window让语言服务器加载。2.2 解释器选不对后面全是玄学Python 扩展装完第一件事不是写代码是选解释器。VSCode 允许一台机器上有多个 Python系统自带、python.org 安装的、conda 环境、venv 虚拟环境它默认可能挑了个你没装库的那个于是import requests报红、运行报 ModuleNotFoundError新手最容易在这里翻车。操作路径CtrlShiftP→ 输入Python: Select Interpreter→ 从列表里选。列表里带(venv: venv)或conda标注的就是虚拟环境优先选项目自己的虚拟环境别选全局的。选完会在项目根目录生成.vscode/settings.json内容类似{ python.defaultInterpreterPath: D:/projects/demo/.venv/Scripts/python.exe, python.terminal.activateEnvironment: true }参数说明python.defaultInterpreterPath是工作区默认解释器路径Windows 指向Scripts/python.exeLinux/macOS 指向bin/pythonpython.terminal.activateEnvironment设为 true 后你在 VSCode 里开终端会自动激活对应虚拟环境省得每次手动source activate。这两个参数是整个配置的地基后面所有插件都读它。2.3 跑通第一个文件确认闭环成立新建hello.py写两行点右上角三角运行import sys print(sys.executable) # 打印当前用的解释器验证选对了没 print(hello vscode)如果输出的解释器路径和你选的一致最小闭环就成了。这一步看着简单但它同时验证了三件事解释器选对、终端能激活环境、运行按钮接的是正确解释器。后面所有问题排查都先回到这一步确认地基没歪。常见做法是把这个文件留在项目里当「体检脚本」换机器、换环境时先跑一遍。3. 补全与类型检查Pylance 的 4 个必调参数3.1 Pylance 和 Python 扩展是什么关系Pylance 是独立的语言服务器扩展Python 扩展会把它作为依赖自动装上。它负责补全、跳转定义、查找引用、类型推断、内联提示。很多人以为补全慢是 VSCode 卡其实是 Pylance 在扫整个项目或者索引了不该索引的目录。它的行为几乎全在settings.json里控制调对了体验差别巨大。3.2 四个真正影响手感的参数{ python.analysis.typeCheckingMode: basic, python.analysis.autoImportCompletions: true, python.analysis.indexing: true, python.analysis.diagnosticSeverityOverrides: { reportMissingImports: warning } }参数说明逐个讲typeCheckingMode有三个档off、basic、strict。新手用basic它会提示明显的类型错误但不烦人strict会把每个没标注类型的函数都标黄写脚本时噪音太大除非你在维护大型库。我一般项目初期用 basic核心模块稳定后再局部开 strict。autoImportCompletions设为 true 后你打DataFrame它会自动补from pandas import DataFrame这是省时间的大头必开。indexing控制是否对第三方库建索引。开了补全能进库内部但首次打开大项目会卡几十秒建索引。项目小就开机器内存紧张或者库特别多可以关掉换启动速度。diagnosticSeverityOverrides用来压掉误报。比如某些动态导入的库 Pylance 找不到reportMissingImports默认是 error 会满屏红改成 warning 眼不见心不烦但别改成 none那样真丢了依赖你也看不见。3.3 什么时候该关掉 Pylance 的某些检查写爬虫、量化策略这类大量用动态属性、getattr、第三方 C 扩展的场景Pylance 会误报一堆「属性不存在」。这时候不是关掉整个 Pylance而是按文件或按规则压{ python.analysis.diagnosticSeverityOverrides: { reportAttributeAccessIssue: none, reportGeneralTypeIssues: warning } }逻辑是reportAttributeAccessIssue对应「对象没有这个属性」的报错动态场景误报最多直接关reportGeneralTypeIssues保留 warning 级别真出问题还能瞄一眼。这种按规则粒度压报错比整个关掉类型检查理性得多也是老手和新手配置的分水岭。4. 格式化与 lintBlack、Ruff、isort 怎么分工不打架4.1 三个工具各管什么别让它们抢活格式化这块最常见的翻车是装了 Black 又装了 autopep8保存时两个都触发代码被来回改。正确分工是——Black 管代码风格缩进、引号、换行isort 管 import 排序Ruff 管 lint未使用变量、未定义名、复杂度。Ruff 现在也能兼做 isort 的活所以更省事的组合是 Black Ruff。pip install black ruff{ editor.formatOnSave: true, editor.defaultFormatter: charliermarsh.ruff, [python]: { editor.defaultFormatter: ms-python.black-formatter, editor.codeActionsOnSave: { source.organizeImports: explicit } } }参数说明editor.defaultFormatter全局设一个再用[python]块覆盖成 Python 专用避免影响你写 JSON、Markdown 的格式化。source.organizeImports设为explicit表示保存时自动整理 import值用explicit而不是true是较新版本的写法老版本写true也行。formatOnSave是总开关不想每次保存都格式化就设 false改成手动ShiftAltF。4.2 Ruff 的配置放哪、怎么配Ruff 支持在pyproject.toml里配比散在 settings.json 里更工程化[tool.ruff] line-length 100 target-version py311 [tool.ruff.lint] select [E, F, I, UP] ignore [E501]参数说明line-length要和 Black 保持一致否则两个工具对同一行是否超长判断不同会互相打架这是血泪经验。select里E/F是 pycodestyle 和 pyflakes 规则I是 import 排序UP是 pyupgrade 现代化建议。ignore掉E501行太长是因为 Black 已经管了换行Ruff 再报一次纯属重复。4.3 保存时到底触发了什么出问题看哪保存一个文件时VSCode 按顺序做先跑 code action整理 import→ 再跑 formatterBlack 格式化→ 最后 Ruff 报 lint。如果发现保存后代码没变先看右下角状态栏有没有格式化器名字没有说明defaultFormatter没生效如果代码被改乱了多半是两个 formatter 同时开着。排查顺序永远是确认只有一个 formatter、确认 line-length 一致、确认 Ruff 和 Black 没同时管换行。5. 调试与运行配置launch.json 里真正要改的字段5.1 为什么点运行能跑调试却断不下来运行按钮走的是「在终端跑 python 文件」调试走的是 debugpy 注入。两者配置是分开的。默认调试配置能应付单文件但一旦涉及传参、指定工作目录、多文件入口就得自己写launch.json。位置在.vscode/launch.json。{ version: 0.2.0, configurations: [ { name: Python: 当前文件, type: debugpy, request: launch, program: ${file}, console: integratedTerminal, cwd: ${workspaceFolder}, args: [--input, data.csv], env: { PYTHONPATH: ${workspaceFolder} } } ] }参数说明type现在用debugpy老配置写python也能兼容但会提示迁移。program用${file}表示调试当前打开的文件改成固定路径就调试指定入口。console设integratedTerminal让程序在集成终端跑能接受 input() 输入设成internalConsole就没法交互这是新手调试爬虫时卡住的常见原因。cwd是工作目录读相对路径文件全靠它。args传命令行参数。env里设PYTHONPATH解决「模块找不到」的导入问题比在每个文件里sys.path.append干净。5.2 断点不生效的三个原因断点是灰的、打不上或者打上了不停通常是解释器选错调试器注入到了另一个 Python、文件没保存debugpy 跑的是磁盘上的旧版本、代码走了多进程子进程默认不继承调试器。前两个改配置就行第三个要在 launch.json 里加subProcess: true才能调试子进程写多进程爬虫、量化回测并行时必加。5.3 条件断点和日志断点比 print 高效在断点上右键可以设条件比如i 100才停和日志消息打印变量但不暂停。调循环里的 bug 时条件断点能让你直接跳到出问题那一次迭代比满屏 print 强太多。日志断点适合「我只想看值不想停」的场景输出到调试控制台不污染代码。6. 避坑与排查插件配置里最容易翻车的 5 件事6.1 补全突然全没了只剩纯文本现象打开 py 文件补全、跳转、报错全消失状态栏显示语言模式是 Plain Text。原因VSCode 没把这个文件识别成 Python常见于文件没保存、后缀不对或者 Python 扩展崩了。解决点右下角语言模式切回 Python不行就CtrlShiftP跑Developer: Reload Window再不行看输出面板里 Python 和 Pylance 的日志有没有报错。6.2 保存时格式化把代码改乱现象每次保存引号、缩进、import 顺序都在变甚至两个工具来回改。原因装了多个 formatter 且都开着或者 Black 和 Ruff 的 line-length 不一致。解决settings.json里只留一个defaultFormatter把 autopep8、yapf 这类卸掉或禁用统一 line-length。6.3 调试时 ModuleNotFoundError但终端里能跑现象终端python main.py正常F5 调试就找不到模块。原因调试器的工作目录或 PYTHONPATH 和终端不一致。解决launch.json 里显式设cwd为${workspaceFolder}env里加PYTHONPATH确认调试用的解释器和终端是同一个。6.4 大项目打开后 Pylance 一直转圈、内存飙升现象打开含大量第三方库或数据文件的项目Pylance 索引卡死。原因它把不该索引的目录数据集、node_modules、build 产物也扫了。解决在 settings.json 里配python.analysis.exclude和files.exclude把数据目录、虚拟环境目录排除掉。{ python.analysis.exclude: [**/data/**, **/build/**, **/.venv/**], files.watcherExclude: { **/.venv/**: true, **/data/**: true } }6.5 虚拟环境装了库VSCode 还是报找不到现象pip install明明成功import 还是红。原因pip 装到了另一个 Python或者 VSCode 选的是全局解释器。解决在 VSCode 集成终端里跑python -m pip install xxx保证 pip 和当前解释器绑定再用Python: Select Interpreter确认选的是同一个环境。养成用python -m pip而不是裸pip的习惯能避开一大半环境错乱。7. 进阶用 settings.json 分层 多环境切换把配置变成可复用资产配置写到后面你会发现真正省事的不是装了多少插件而是把配置分层管理。VSCode 的 settings 有三个层级优先级从低到高用户级全局所有项目共享、工作区级.vscode/settings.json跟项目走、文件夹级多根工作区用。我的习惯是用户级只放和项目无关的通用项字体、主题、formatOnSave总开关工作区级放和这个项目强相关的解释器路径、lint 规则、exclude 目录。这样换项目时通用手感不变项目专属配置跟着仓库走团队里别人 clone 下来直接就是一套配好的环境。多环境切换是另一个高频需求。同一台机器上跑爬虫用一套依赖、跑量化回测用另一套靠虚拟环境隔离靠Python: Select Interpreter切换。切完记得看一眼终端有没有重新激活没激活就手动deactivate再激活。下面这张表是我常用的插件清单和它们各自负责的环节按需装别一次全上插件扩展 ID负责环节是否必装Pythonms-python.python解释器、调试、运行必装Pylancems-python.vscode-pylance补全、类型检查必装Black Formatterms-python.black-formatter代码格式化推荐Ruffcharliermarsh.rufflint import 排序推荐Jupyterms-toolsai.jupyternotebook、数据分析按需Even Better TOMLtamasfe.even-better-toml编辑 pyproject.toml按需最后说一个验证配置是否真的生效的技巧改完 settings.json 不要凭感觉打开命令面板跑Developer: Inspect Editor Tokens and Scopes看语言模式跑Python: Show Output看语言服务器日志跑一次格式化看右下角格式化器名字。配置这东西看得见才算数。我自己这些年最大的教训是别追求一次配到完美先把「解释器 Python 扩展 一个 formatter」这三样跑通用一周缺什么补什么。一上来照着别人的插件清单全装一遍最后大概率是插件互相打架你还不知道是哪个的锅。配置是长出来的不是抄出来的。希望帮到你。本文还有配套的精品资源点击获取