- 虚拟环境路径包含中文、空格或特殊符号
VSCode 对中文路径支持不好，会识别失败。
→ 项目文件夹必须全英文、无空格。
- 没选中正确的解释器（只选了文件夹，没选 python.exe）
虚拟环境真正的解释器是：
-
Windows： .venv\Scripts\python.exe
-
Mac/Linux： .venv/bin/python
只选 .venv 文件夹是无效的。
- VSCode 没有加载出新创建的 venv
刚创建完虚拟环境，VSCode 缓存没刷新，列表里不显示。
→ 重启 VSCode 即可。
- VSCode Python 插件未安装或失效
没有官方 Python 插件，就无法切换解释器。
→ 安装插件： ms-python.python 。
- 系统权限问题 / 虚拟环境损坏
文件夹被锁定、权限不足，或创建时出错导致 venv 不完整。
→ 删除 .venv 重新创建。
- 终端激活的环境与VSCode选中的环境不一致
右下角显示对了，但终端还是旧环境。
→ 关闭终端重新打开，或手动 deactivate 再激活。
- 多个Python版本冲突（系统Python vs 安装版Python）
电脑装了多个Python，VSCode 识别混乱。
→ 手动输入路径指定解释器。
- .venv 被设置为排除文件夹
settings.json 里如果把 .venv 排除搜索，解释器也会找不到。