VSCode Python配置不能仅靠同步，因python.defaultInterpreterPath等绝对路径字段会被静默过滤导致新设备解释器丢失、终端失效；须分层处理：全局同步通用设置，本地路径移至工作区.settings.json并加// @sync false标记，插件需手动刷新安装。
VSCode 的 Python 开发配置不能靠“同步就完事”，python.defaultInterpreterPath、terminal.integrated.profiles.windows 这类字段会被静默跳过，直接同步会导致新设备上 Python 扩展报错、终端打不开、调试器失效——必须分层处理：全局配置同步 + 本地路径隔离 + 插件状态手动确认。
为什么 Python 解释器路径总在新设备上变空？
VSCode 同步机制会主动过滤所有含绝对路径或平台强依赖的配置项，python.defaultInterpreterPath 就是典型。它不会报错，也不会提示“已跳过”，只是上传时自动剔除，下载后该字段就是 null 或空字符串。
- macOS 上你设的是
"/opt/homebrew/bin/python3"，同步到 Windows 设备后，这个值直接消失，Python 扩展找不到解释器，连“Select Interpreter”按钮都灰掉 -
terminal.integrated.profiles.windows和terminal.integrated.profiles.linux互不兼容，同步后 Windows 设备可能加载不到 PowerShell，Linux 设备反而多出一堆无效 profile - 解决办法不是硬塞路径，而是加注释标记：
// @sync false放在该配置项上方，强制跳过同步；把真实路径移到工作区级.vscode/settings.json中（工作区设置天然不同步，正好符合需求）
插件列表同步了，但 ms-python.python 卡在 Installing… 怎么办？
Settings Sync 只同步“安装清单”，不触发实际安装流程。尤其 ms-python.python 体积大、依赖多，网络波动或扩展市场限流时极易卡住。
- 打开扩展面板（
Ctrl+Shift+X），找到ms-python.python，点右上角刷新图标（?），手动重试安装 - 检查
extensions.autoUpdate是否为true：如果是false，即使同步了插件 ID，也不会自动更新或重装 - 若仍失败，运行命令面板 →
Developer: Toggle Developer Tools，看 Console 里是否报ENOTFOUND python或429 Too Many Requests—— 前者说明解释器路径没配好，后者需等几分钟再试
如何让 Python 相关配置既可迁移又不崩？
核心思路是“拆”：把跨设备通用的部分（如格式化工具、lint 规则、代码片段）放用户级 settings 同步；把机器专属部分（解释器路径、终端 profile、调试 launch 配置）全部移出用户设置。
立即学习“Python免费学习笔记（深入）”；
- 用户级
settings.json保留这些安全项："python.formatting.provider": "black"、"python.linting.enabled": true、"python.testing.pytestArgs" - 所有带路径的配置，统一移到项目根目录下的
.vscode/settings.json，例如："python.defaultInterpreterPath": "./.venv/bin/python"（相对路径）或"python.defaultInterpreterPath": "${env:HOME}/.pyenv/versions/3.11.9/bin/python"（环境变量） - 调试配置
launch.json必须放在.vscode/下，且不要写死"pythonPath"（已废弃），改用"justMyCode": true+"console": "integratedTerminal"提升兼容性
最容易被忽略的一点：同步后，ms-python.python 插件本身会尝试读取 python.defaultInterpreterPath，但如果这个字段在用户 settings 里是空的，它不会 fallback 到工作区设置——它就直接停在那里。所以务必确认工作区 settings.json 存在且被 VSCode 正确加载（状态栏右下角应显示 Python 版本号，而不是“Python not selected”）。
