VSCode中Python文件不会自动编译，因Python是解释型语言；所谓“自动编译”实为保存后自动运行或触发lint/format检查，需通过tasks.json或watchexec实现。
VSCode 里 Python 文件根本不会“自动编译”
Python 是解释型语言，没有传统意义上的“编译”环节；所谓“自动编译”，实际是指保存后自动运行（python xxx.py）或触发 lint/format 等检查流程。VSCode 本身不提供一键编译 Python 的功能，必须靠 tasks.json 或外部监听工具串联动作。
files.autoSave 配什么值才对 Python 项目真正有用
Python 脚本常需快速试错、频繁调试，files.autoSave 设错会导致未验证代码提前落盘，甚至干扰 venv 中的依赖解析。推荐用 afterDelay，但必须配好延迟：
-
files.autoSave设为"afterDelay"，别用onFocusChange——切到终端查日志就存一次，容易把 print 调试语句误提交 -
files.autoSaveDelay建议设为1000（毫秒），太小（如100）在 WSL 或远程开发中会卡顿，太大（如3000）又失去及时性 - 如果项目根目录有
.vscode/settings.json，它会覆盖用户级设置；按Ctrl+Shift+P→Preferences: Open Workspace Settings (JSON)确认当前生效项 - 某些路径会被跳过：若
files.exclude匹配了**/*.py或**/__pycache__/**，自动保存可能静默失效
保存后自动运行 Python 脚本的两种可靠方式
VSCode 不支持“保存即执行”，但可通过任务（tasks.json）或终端监听实现。关键是要避开插件封装层，走原生机制：
- 用
tasks.json启动python：在.vscode/tasks.json中写入：{ "version": "2.0.0", "tasks": [ { "label": "run python", "type": "shell", "command": "python ${file}", "group": "build", "presentation": { "echo": true, "reveal": "always", "focus": false } } ] }然后在settings.json加："editor.codeActionsOnSave": { "source.organizeImports": true }（可选），再绑定快捷键或用命令面板运行该任务 - 用
watchexec监听（更稳定）：终端执行watchexec -r --exts py --on-change "python ${file}"；它比nodemon更轻量，且不依赖 Node.js，适合纯 Python 环境 - 别装 “Auto Runner” 类插件：它们常绕过 VSCode 的保存生命周期，导致
editor.formatOnSave失效、Git 脏检查漏判
为什么保存后没反应？先看这三处报错
常见假性失效，其实不是配置问题，而是底层链路断了：
立即学习“Python免费学习笔记（深入）”；
- 打开开发者工具（
Ctrl+Shift+I）→ Console 标签页，搜No formatter registered for 'python'：说明editor.formatOnSave开了但没配默认 formatter，需加"[python]": "ms-python.black-formatter"到editor.defaultFormatter - 运行任务时报错
Command 'python' not found：不是 PATH 问题，是 VSCode 没读取到你激活的虚拟环境；务必通过Python: Select Interpreter命令选中venv/bin/python（Linux/macOS）或venv\Scripts\python.exe（Windows） - 保存后终端无输出，但文件确实写了磁盘：检查是否启用了
editor.formatOnSaveMode且设为modifications——当代码有语法错误时，Prettier/Black 会拒绝格式化，VSCode 默认也不执行后续任务，看起来像“没反应”
真正麻烦的是混合场景：比如你在 WSL 里编辑 Windows 路径（/mnt/c/project/），files.autoSaveDelay 可能翻倍，而 watchexec 对 NTFS 文件系统事件监听不稳定。这种时候，不如关掉自动保存，改用 Ctrl+S + Ctrl+Shift+P → Tasks: Run Task 手动触发，反而更可控。
