<p>VSCode Python开发必须启用Pylance、禁用Jedi;Jupyter插件仅对.ipynb和含# %%的.py文件生效;Black格式化应手动触发而非保存时自动执行;调试参数优先使用命令面板动态输入;所有插件启用范围须设为工作区级别。</p>

VSCode 插件不是装得越多越好,真正影响日常开发效率的往往就那 5–8 个,且必须按项目类型分层配置——纯前端、Python 后端、CLI 工具链三类场景,插件冲突和启动延迟问题几乎都源于无差别全局安装。
哪些插件必须禁用自动更新
自动更新看似省心,但 ESLint、Prettier、Python(官方插件)这三类在中大型项目里极易引发格式化逻辑错乱或 lint 规则失效。比如 ESLint 升级到 v9 后默认启用 flat config,而你项目仍用 .eslintrc.js,就会静默跳过校验。
- 在插件页点击齿轮图标 → 选择「Disable Auto Update」
- 对
Python插件额外关闭python.defaultInterpreterPath的自动探测(改用 workspace 级settings.json固定路径) - 禁用后手动升级前,先跑
npm run lint或pylint验证规则兼容性
为什么 EditorConfig + Prettier + ESLint 会互相打架
三者职责重叠又不完全覆盖:EditorConfig 控制基础缩进/换行,Prettier 负责代码样式重写,ESLint 检查逻辑+部分格式。冲突常出现在 quotes、semi、max-len 这些选项上。
- 统一交由
Prettier掌控格式,ESLint 关闭所有 stylistic 规则(用eslint-config-prettier) - EditorConfig 只保留
root = true和charset = utf-8,其余删掉——Prettier 已覆盖 - 在
.prettierrc中显式写"semi": false,别依赖 ESLint 的semi: "off",后者不触发 Prettier 重写
Python 开发绕不开的三个插件组合
单装 Python 官方插件不够,缺了 Pylance 会丢失类型提示跳转,没 Black Formatter 则无法一键格式化(autopep8 已停更,yapf 不兼容 Python 3.12+)。
-
Pylance必须开启"python.languageServer": "Pylance",否则类型推导退化为基本语法高亮 -
Black Formatter需在 workspace 设置中指定"editor.formatOnSave": true和"python.formatting.provider": "black" - 避免同时启用
autopep8和black,VSCode 会随机调用其中一个,导致保存两次格式化
前端项目慎用 Live Server 的两个时机
Live Server 适合静态 HTML 快速预览,但在 Vue/React 项目里直接点「Go Live」等于绕过构建流程,CSS Modules、环境变量、路由 history 模式全失效。
- Vue 项目用
npm run serve,React 用npm start,让 webpack/vite 处理热更新 - 真要本地起服务时,改用
serveCLI:npx serve -s build(生产构建后),比 Live Server 更接近真实部署 - 如果误点了 Live Server 导致页面白屏,检查浏览器控制台是否报
Failed to load module script——这就是没走打包流程的典型信号
插件配置最易被忽略的是作用域层级:用户级设置会被工作区设置覆盖,而工作区设置又可能被 .vscode/settings.json 里的 files.associations 或 emeraldwalk.runonsave 类插件二次覆盖。调试时优先看右下角状态栏的语言模式和格式化工具图标,它比设置文件更真实地反映当前生效项。


















