vs code 安装 python 扩展后必须手动设置 python.defaultinterpreterpath 为完整路径，否则 import 报错、调试断连、补全失效；它不继承 shell 配置或虚拟环境，需通过 python: select interpreter 选择明确路径并固化到 .vscode/settings.json。
VS Code 安装完 Python 扩展后，python.defaultInterpreterPath 不会自动设置——它必须手动指定完整路径，否则 import 报错、调试断连、补全失效都是必然结果。
为什么 VS Code 找不到你终端里能跑的 Python
VS Code 启动时不会读取你的 shell 配置（比如 ~/.zshrc 或 PATH），也不继承已激活的虚拟环境。你在终端输入 python --version 成功，不代表 VS Code 知道那个解释器在哪。
- 检查是否以「文件夹」形式打开项目：File → Open Folder，不能只打开单个
.py文件 - 确认系统级 Python 已安装且可执行：终端运行
which python3（macOS/Linux）或where python（Windows），无输出就先重装 Python 并勾选Add Python to PATH - conda/poetry/pipenv 用户需额外验证：终端运行
conda env list或poetry env info --path拿到真实路径，再手动填
Python: Select Interpreter 列表为空或选错怎么办
这是最常卡住的一步。列表为空 ≠ 没有解释器，而是 VS Code 没扫描到；列表里有条目 ≠ 选对了——模糊名称如 Python 3.12 或 python3 很可能指向系统全局解释器，不是你的项目虚拟环境。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 优先选带明确路径的项，例如：
./venv/bin/python（Linux/macOS）、. envScriptspython.exe（Windows）、~/miniconda3/envs/myproj/bin/python - 若列表为空，点
Enter interpreter path…，粘贴终端查出的绝对路径（注意 Windows 路径中要写成\或用正斜杠/） - 选完立刻看右下角状态栏是否显示该路径；没变？关掉整个 VS Code 窗口（不是仅关闭标签页），重新打开项目文件夹
如何让配置跨重启生效，不每次重选
UI 上选一次只对当前工作区临时有效。要固化，必须写进 .vscode/settings.json，且字段名在新版中已是 python.defaultInterpreterPath，旧字段 python.pythonPath 已废弃。
- 打开设置：按
Ctrl+,→ 右上角点「打开设置(JSON)」图标 - 添加这一行（路径是相对于项目根目录的）：
"python.defaultInterpreterPath": "./venv/bin/python"（macOS/Linux）或"python.defaultInterpreterPath": ".\venv\Scripts\python.exe"（Windows） - 保存后，VS Code 的终端、调试器、Pylance 补全全部强制使用这个解释器——这是避免环境错乱的核心防线
- 路径含中文或空格（如
C:Users张三project.venvScriptspython.exe）多数功能正常，但 Pylance 类型推导可能失效，建议避开
虚拟环境路径 VS Code 为什么识别不了
VS Code 默认只在项目根目录下检查固定名称的文件夹：.venv、venv、env，且不递归搜索子目录。名字不对、位置不对、创建方式不对，都会导致“看不见”。
- 用
python -m venv myenv创建的，名字不是venv或.venv→ VS Code 不识别，必须手动输路径 - 在
~/pyenvs/myproject/创建了 venv，却打开~/myproject/文件夹 → 根本扫不到 - 用
pipenv或poetry创建的环境，路径不标准 → 运行pipenv --venv或poetry env info --path获取真实路径再填 - Mac 用户特别注意：VS Code 默认可能用
bash启动，而你日常用zsh，conda命令不可达 → 终端里能conda env list，VS Code 里却列不出
真正容易被忽略的是：VS Code 的 Python 功能（包括调试、终端、linter、补全）全部依赖同一个解释器路径，只要有一处没对齐，问题就会以不同形式反复出现。别信“自动检测”，路径必须显式、完整、固化。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
