VSCode配置Python项目与虚拟环境的联动-VSCode-PHP中文网

vscode不会自动绑定项目与虚拟环境，必须手动指定解释器路径；需通过python: select interpreter选择./.venv/bin/python（macos/linux）或./.venv/scripts/python.exe（windows），并启用python.terminal.activateenvironment确保终端自动激活，路径须为相对路径且以./开头，同时必须用open folder打开项目根目录。

vscode配置python项目与虚拟环境的联动

VSCode不会自动把项目和虚拟环境绑在一起，必须手动指定解释器路径，否则编辑器、终端、调试器三者用的可能是三个不同的Python环境。

Python: Select Interpreter 选不对，补全和调试就失效

VSCode的代码补全、类型检查、断点调试都依赖所选解释器的site-packages。如果误选了系统Python或别的venv，import requests可能标红，ModuleNotFoundError在调试时突然冒出，但终端里pip install明明成功了。

务必通过 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac）打开命令面板，输入并执行 Python: Select Interpreter
列表里优先选带 (venv) 标记的项，比如 ./.venv/bin/python（macOS/Linux）或 ./.venv/Scripts/python.exe（Windows）
如果没出现，点击 Enter interpreter path，手动导航到虚拟环境里的 python 可执行文件 —— 不是 activate 脚本，也不是 pip
选完后右下角状态栏会显示路径，鼠标悬停可确认是否指向 .venv 内部

终端不自动激活虚拟环境，pip install 白装了

即使解释器选对了，VSCode集成终端默认仍用系统shell启动，不会继承你刚选的venv。结果就是：你在终端里 pip install numpy，但编辑器里 import numpy 还是报错。

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的双功能合体技能，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途：；核心要点📝 题解模式：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

打开设置（Ctrl+,），搜索 python.terminal.activateEnvironment，设为 true
这个开关只对新打开的集成终端生效；已打开的终端需关闭重开，或手动运行 source .venv/bin/activate（macOS/Linux）或 .venv\Scripts\activate（Windows）
验证是否生效：在终端里执行 which python（macOS/Linux）或 where python（Windows），输出路径必须含 .venv
顺手跑 pip --version，确保它和 python -m pip --version 输出一致 —— 否则说明pip没走venv里的

.vscode/settings.json 里的路径必须是相对路径

如果你在 settings.json 里硬编码绝对路径（比如 /Users/me/project/.venv/bin/python），换台电脑或给同事发项目就会失效。VSCode要求路径相对于工作区根目录。

正确写法："python.defaultInterpreterPath": "./.venv/bin/python"（macOS/Linux）或 "python.defaultInterpreterPath": "./.venv/Scripts/python.exe"（Windows）
路径开头的 ./ 不能省，否则VSCode可能当成绝对路径处理
这个配置只对当前工作区生效，建议提交到Git（除非含敏感信息），方便团队统一环境
创建venv时推荐用 python -m venv .venv，而不是 virtualenv .venv —— 前者结构更标准，VSCode识别率更高

调试时PYTHONPATH没继承，src/结构项目必挂

如果你的项目用 src/ 目录结构（即代码在 src/ 下，而非项目根目录），即使解释器选对、终端也激活了，调试仍可能报 ImportError: attempted relative import with no known parent package。

根本原因是：VSCode调试器不读shell的激活状态，也不自动把 src/ 加进 PYTHONPATH
在 .vscode/launch.json 的配置里，显式加 "env": {"PYTHONPATH": "${workspaceFolder}/src"}
同时确认 "cwd" 设为 "${workspaceFolder}"，避免工作目录错位
若用Pylance做类型检查，还需在 pyrightconfig.json 或 pyproject.toml 中声明 src 为源码根目录，否则补全无效