直接换解释器路径即可，无需重装包或同步site-packages；vscode只认路径，迁移关键是环境定义和配置指向，需分别刷新终端、调试器和jupyter kernel以确保生效。
直接换解释器路径就行，不用重装包、不复制 Lib 文件夹、也不用手动同步 site-packages——VSCode 本身不管理 Python 包，只认解释器路径。真正要迁移的是「环境定义」和「VSCode 的配置指向」。
Python: Select Interpreter 列表为空？先查真实可执行文件
VSCode 不会自动扫描所有 Python 安装位置，它依赖扩展主动探测。列表为空不是配置错了，而是根本没找到可执行文件。
- Windows 上运行
where python或py -0p（需启用 Windows Python Launcher） - macOS/Linux 运行
which python3.11、pyenv which 3.10或conda activate myenv && python -c "import sys; print(sys.executable)" - conda 环境必须先运行
conda init并重启 VSCode，否则扩展看不到conda list里的环境 - venv 必须放在项目根目录下（如
.venv或venv），嵌套在envs/里不会被自动发现
选了解释器但终端/调试器/Jupyter 还是旧版本？三处要分别刷新
VSCode 的解释器设置只影响新启动的组件，已有进程不继承变更。
- 终端：已打开的集成终端（
Ctrl+`）不会自动切换，必须关闭重开；或在终端里运行refreshenv（Windows + Chocolatey）或source ~/.zshrc（macOS/Linux） - 调试器：改了解释器后必须点 Restart Debugging，否则继续跑旧进程
- Jupyter：右上角 kernel 名字常滞后，必须点它 → Change kernel → 手动选带对应名称的 kernel（如
Python (myenv)） - 特别注意：
conda环境选完若import numpy报错，大概率是漏装ipykernel：conda activate myenv && pip install ipykernel && python -m ipykernel install --user --name myenv --display-name "Python (myenv)"——--user是关键，不加会导致 kernel 装进环境内部，VSCode 找不到
.vscode/settings.json 里写了 python.defaultInterpreterPath 还切不了？检查覆盖关系
工作区设置优先级高于全局设置。如果该工作区之前手动选过解释器，VSCode 会在 .vscode/settings.json 里写入 python.defaultInterpreterPath，此时全局设置（settings.json 用户级）会被忽略。
- 想强制用全局默认，删掉工作区
.vscode/settings.json里的python.defaultInterpreterPath行 - 想让路径更健壮，用
${workspaceFolder}变量代替绝对路径，例如："python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python"（macOS/Linux）或"python.defaultInterpreterPath": "${workspaceFolder}\\.venv\\Scripts\\python.exe"（Windows） - 路径写错会导致解释器图标灰掉、
Ctrl+Shift+P里命令失效，务必确认路径存在且可执行
最容易被忽略的是 Jupyter kernel 和解释器不是一回事——选对了解释器，不代表 kernel 就跟着换；而 kernel 没装好，import 就会失败。别只盯着状态栏那个 Python 版本数字，得进终端和 notebook 都验证一遍。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
