VSCode右下角选了解释器但终端仍显示旧版本，根本原因是终端环境未与编辑器同步；需设置"python.terminal.activateEnvironment": true并重启终端，且解释器路径必须精确到python.exe或python文件而非venv文件夹。
状态栏选了但终端没同步
VSCode右下角点了正确的解释器，python --version在集成终端里却还是旧版本——这是最常被忽略的“半生效”状态。根本原因是终端环境和编辑器内核没绑定。
检查 python.terminal.activateEnvironment 是否设为 true；如果没配，终端默认用系统PATH里的第一个python，和你选的解释器完全无关。
- 打开
.vscode/settings.json，确认有这一行："python.terminal.activateEnvironment": true - 改完后重启终端（不是重载窗口），再执行
pip -V验证路径是否指向虚拟环境 - PowerShell用户额外注意：
venv\Scripts\activate.ps1默认被策略阻止，得先运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
手动填路径时误选venv根目录
很多人把 ./venv 直接填进解释器路径框，结果VSCode报 Cannot find Python interpreter。venv路径必须精确到可执行文件，不是文件夹。
Windows下正确路径是 ./venv/Scripts/python.exe，macOS/Linux是 ./venv/bin/python。填错会导致Pylance无法加载类型信息，import提示全红，go to definition 失效。
立即学习“Python免费学习笔记（深入）”；
- 别用资源管理器双击打开venv文件夹再复制路径——容易漏掉
Scripts或bin子目录 - 更稳妥的方式：在终端进入venv后执行
python -c "import sys; print(sys.executable)"，复制输出结果 - 如果路径含空格或中文，VSCode能识别，但某些旧版扩展可能解析失败，建议路径尽量简洁
conda环境路径写死后失效
用 conda activate myenv 后手动记下 python.exe 路径填进VSCode，过几天conda更新或重装就404——因为conda环境路径不固定，尤其Windows上envs\myenv 可能被移到pkgs缓存区。
推荐用命令动态查路径：conda activate myenv && python -c "import sys; print(sys.executable)"。这个输出才是当前激活状态下真实有效的解释器位置。
- 不要信任
conda env list显示的路径，它只是注册表快照，不一定对应磁盘实际位置 - 如果conda环境名含特殊字符（如
my-env），路径中可能出现%20等编码，直接粘贴会失败 - 多用户机器上，conda可能把环境建在
C:\Users\Public\Anaconda3\envs，而当前用户没读取权限，得检查路径ACL
Python扩展日志里藏着真实错误
解释器列表为空、点击无响应、选完立刻变灰……这些现象背后，往往不是配置问题，而是Python扩展在后台扫描时被卡住或静默失败。光看界面没法定位。
打开输出面板（Ctrl+Shift+U），切换到Python频道，滚动到底部看最后几行。常见线索包括：Failed to parse interpreter output、permission denied、timeout waiting for interpreter。
- 如果看到
spawn python ENOENT，说明VSCode试图调用python命令失败，要检查系统PATH是否真包含该解释器 - 日志里出现大量
fs.stat错误，可能是某层目录权限异常，尤其在OneDrive或WSL挂载路径下 - 清缓存不是万能解法：
Python: Clear Cache and Reload Window仅清扩展内存缓存，不删磁盘索引，真正要删的是%USERPROFILE%\.vscode\extensions\ms-python.python-*/cache目录
