VSCode不会自动绑定项目与虚拟环境，必须手动指定解释器路径；需通过Python: Select Interpreter选择./.venv/bin/python（macOS/Linux）或./.venv/Scripts/python.exe（Windows），并启用python.terminal.activateEnvironment确保终端自动激活，路径须为相对路径且以./开头，同时必须用Open Folder打开项目根目录。
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 还是报错。
- 打开设置（
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要求路径相对于工作区根目录。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- 正确写法：
"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为源码根目录，否则补全无效
最常被忽略的其实是「打开方式」：必须用 File > Open Folder 打整个项目根目录（含 .venv 和 .vscode），而不是双击单个 .py 文件 —— 后者压根不会加载工作区设置，所有配置形同虚设。
