VSCode终端默认不继承系统shell完整环境，导致python命令不可用或指向错误版本，根源在于GUI启动时未加载~/.zshrc等初始化文件；需通过配置terminal.integrated.profiles加-l参数、启用python.terminal.activateEnvironment并设准python.defaultInterpreterPath，或手动补PATH与PYTHONPATH实现环境同步。
VSCode 集成终端默认不继承系统级 shell 的完整环境（比如 ~/.zshrc 或 conda init 注册的命令），直接敲 python script.py 很可能调用错解释器、找不到包、甚至报 command not found: python——这不是 VSCode 故障，而是终端启动时没加载你依赖的初始化逻辑。
为什么终端里 python 命令不可用或指向错误版本
常见现象：在 VSCode 终端里输入 python --version 报错，或返回系统自带的 2.7/3.8，而你明明装了 3.12 并在 ~/.zshrc 里用 pyenv global 3.12.1 设过；或者 Windows 上只认 py 不认 python。
- VSCode 默认以“login shell”方式启动终端（如
zsh -l），但 GUI 启动时（双击图标）可能跳过 shell 配置文件读取，尤其是 macOS/Linux 上~/.zshrc没被触发 - Windows PowerShell 默认不执行
conda init powershell生成的初始化块，除非你手动运行过或改过执行策略 -
where python（Windows）或which python3（macOS/Linux）输出路径，必须和 VSCode 右下角状态栏显示的解释器路径**完全一致**；差一个字符都不行
python -m 模式比直接执行脚本更可靠
当你写 from mypackage.utils import helper 却在终端报 ModuleNotFoundError，问题不在代码，而在 Python 启动时没把项目根加进 sys.path。用 -m 模式能绕过 cwd 依赖，前提是包结构合规（含 __init__.py）。
- 正确用法：
python -m mypackage.main（当前目录需是mypackage的父目录） - Windows 推荐统一用
py -m mypackage.main，它会自动匹配已注册的 Python 版本，且无视 PATH 中的python别名 - 避免
python script.py：如果script.py在子目录（如src/main.py），相对导入会崩，且无法跨包引用 - 调试时仍要配
launch.json：F5 调试不走终端环境，"module": "runpy"是安全默认，别改成"python"
让新终端自动加载你的系统级环境
每次手动 source ~/.zshrc 或运行 conda activate myenv 太重复。VSCode 提供两个底层开关，但必须配对生效：
立即学习“Python免费学习笔记（深入）”；
- 启用自动激活：
"python.terminal.activateEnvironment": true（加到settings.json），它会让新终端自动运行.venv/Scripts/activate.bat或source .venv/bin/activate - 但前提是
python.defaultInterpreterPath已设为项目内虚拟环境路径（如"./.venv/bin/python"），否则它不知道该激活谁 - Mac 用户额外检查：
echo $SHELL看是否真在 zsh，再确认~/.zshrc末尾有export PYENV_ROOT="$HOME/.pyenv"和command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH" - 改完设置后，必须关闭所有已打开的终端页签再新建——旧终端进程不会重载配置
PYTHONPATH 是唯一同时喂饱 Pylance 和运行时的变量
编辑器标红 from xxx import yyy，但终端里能跑通？说明 Pylance 没读到你的模块路径。靠 sys.path.append() 或 code-runner.fileDirectoryAsCwd 只骗得了一次运行，不是长期解法。
- 在项目根目录的
.vscode/settings.json中加环境变量："terminal.integrated.env.osx": { "PYTHONPATH": "${workspaceFolder}:${env:PYTHONPATH}" }（macOS/Linux）"terminal.integrated.env.windows": { "PYTHONPATH": "${workspaceFolder};${env:PYTHONPATH}" }（Windows） - 这个值必须和
launch.json中的"cwd"和"env.PYTHONPATH"保持一致，否则调试时照样报错 - 改完后关终端、重启 VSCode（不是重载窗口），否则 Pylance 缓存不刷新
最常被忽略的一点：VSCode 的“终端”和“调试器”是两套独立环境，它们只共享 PYTHONPATH 和解释器路径配置；其他一切（shell 别名、conda env、PATH 修改）都得各自显式激活。别指望选个解释器就万事大吉。
