files.autosave 对 python 文件无效的三大主因：一是 untitled 文件无磁盘路径，必须先 save as 才生效；二是工作区 .vscode/settings.json 覆盖全局设置；三是 python 扩展或 linter 在保存时阻塞写入。
files.autoSave 对 Python 文件无效，通常不是 Python 特有问题，而是 VSCode 自动保存机制本身不区分语言——它只认文件路径、状态和配置优先级。失效根本原因往往藏在三个地方：文件没真正落地、设置被覆盖、或语言服务器干扰保存流程。
为什么 Untitled-1 或未保存的 Python 文件从不自动保存
VSCode 的 files.autoSave 完全不作用于无磁盘路径的编辑器标签。新建一个 Python 文件（左下角显示 Untitled-1），哪怕你已设好 "files.autoSave": "onFocusChange"，它也永远不会写入任何内容。
- 必须先执行
File > Save As（或Ctrl+Shift+S）并指定真实路径，比如./src/main.py - 保存后，左下角状态栏会显示完整路径，此时自动保存才开始监听变更
- 若用命令面板运行
Python: Create Terminal后直接粘贴代码进新标签，同样属于Untitled场景，需手动落盘
工作区 .vscode/settings.json 覆盖了你的全局设置
VSCode 设置有明确优先级：工作区设置 > 用户设置。如果你在项目根目录下有 .vscode/settings.json，里面写了 "files.autoSave": "off"，那无论你在用户设置里怎么调，对这个项目都无效。
- 打开命令面板（
Ctrl+Shift+P），运行Preferences: Open Workspace Settings (JSON)查看当前生效的配置 - 检查是否存在
files.autoSave字段；若有，删掉它或改成"afterDelay"/"onFocusChange" - 特别注意：某些 Python 项目模板（如 cookiecutter-django）自带的
.vscode/settings.json会默认关掉自动保存，只为避免误提交临时调试代码
Python 扩展或 Linter 在保存时阻塞写入
当你启用 editor.codeActionsOnSave 或 python.linting.enabled 后，保存动作会变成“写入 → 触发 Linter → 等待修复 → 再写入”。如果 Pylint/Ruff/ESLint 检查超时或卡住，VSCode 可能静默失败——看起来像“没保存”，其实是保存被挂起。
- 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），切到 Console 标签，复现一次保存操作，看是否有Failed to run code action或timeout报错 - 临时禁用 Python 相关扩展（尤其是
ms-python.python和charliermarsh.ruff-vscode），再试保存是否恢复 - 若确认是 Linter 拖慢，可在
settings.json中限制其作用范围："python.linting.enabled": false，或改用更轻量的"python.formatting.provider": "black"替代完整 lint 流程
远程开发（SSH/Dev Containers）下 files.autoSave 不听本地设置
如果你通过 Remote-SSH 连到 Linux 服务器，或使用 Dev Containers，VSCode 的自动保存行为完全由远程端的 VS Code Server 控制。你在本地用户设置里改的 files.autoSave 不会同步过去。
- 必须在远程环境中单独配置：连接后，打开设置（
Ctrl+,），搜索auto save，修改远程端的files.autoSave - 或者，在远程项目的
.vscode/settings.json里显式声明："files.autoSave": "onFocusChange" - 注意：远程文件系统（如 NFS 挂载）可能响应慢，
afterDelay模式下的小延迟（如 300ms）容易被掩盖，建议设为1500以上
最常被忽略的一点：自动保存只管“把内存内容写进磁盘”，不管“写进去的内容是否合法”。哪怕你敲了 prnt("hello")，它也会照存——修复靠的是 editor.codeActionsOnSave 和后端语言服务，二者必须分开配、分开验。别指望开个 autoSave 就能防语法错误。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
