VSCode中Python环境变量不生效的根本原因是进程继承机制隔离：终端、调试器、Jupyter kernel各自启动方式不同，均不自动加载用户shell配置（如~/.zshrc），仅继承GUI会话初始环境；macOS读~/.zprofile、Linux读~/.profile、Windows完全忽略shell配置，Jupyter kernel更与终端彻底隔离。
VSCode 中 Python 运行时环境变量不生效，不是配置漏了，而是环境继承路径根本没走通——终端、调试器、Jupyter kernel 各自加载环境的方式完全不同，不能指望改一处就全局生效。
为什么 echo $HF_HOME 在终端里有，但 os.getenv("HF_HOME") 在 Python 里返回 None
根本原因在于：VSCode 启动的 Python 进程（无论是调试器、测试、还是 Jupyter kernel）**不执行你的 shell 配置文件**（如 ~/.zshrc 或 ~/.bashrc），它只继承启动时 GUI 会话的初始环境。而你在终端里手动 export HF_HOME=...，只影响那个终端及其子进程；VSCode 是独立 GUI 进程，完全看不到。
- macOS 下 VSCode 图形启动读的是
~/.zprofile，不是~/.zshrc - Linux 桌面环境通常读
~/.profile，且只在登录时加载一次 - Windows 根本不读用户 shell 配置，只认「系统属性 → 环境变量」里的系统级 PATH 和变量
- Jupyter kernel 更彻底：它由
ipykernel启动，和你当前终端 shell 完全隔离，除非显式注入，否则连PATH都可能被截断
如何让 Python 解释器真正拿到你设的环境变量
最可靠的做法是把变量绑定到 Python 环境本身，而不是依赖外部 shell 继承。尤其适用于 Conda 或 venv 场景：
- Conda 用户：用
conda env config vars set HF_HOME=/path/to/hf，然后conda deactivate && conda activate myenv—— 变量会写入myenv/etc/conda/activate.d/env_vars.sh，每次激活自动生效 - venv 用户：在虚拟环境的
bin/activate（macOS/Linux）或Scripts/activate.bat（Windows）末尾追加export HF_HOME=/path/to/hf（注意 Windows 用set HF_HOME=...） - 不推荐在
launch.json的env字段硬编码，因为这仅对调试器生效，不影响python -m pytest或终端里直接运行的脚本
VSCode 集成终端里 PATH 和变量仍不对？检查这三个地方
即使你改了 ~/.zprofile，VSCode 终端也可能不加载——因为它默认启动的是「非登录 shell」，跳过了 profile 文件。
立即学习“Python免费学习笔记（深入）”；
- macOS：在
settings.json加上"terminal.integrated.shellArgs.osx": ["-l"]，强制以登录 shell 启动 - Linux：对应字段是
"terminal.integrated.shellArgs.linux"，同样加-l - Windows：PowerShell 需确保执行策略允许脚本：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，否则Scripts/activate.ps1会被阻止 - 改完后必须彻底退出 VSCode（Activity Monitor / 任务管理器杀掉所有
Code Helper和Code.exe进程），再重开——GUI 应用不会热更新环境
tasks.json 和 launch.json 的 env 字段为什么总像没起作用
因为它们的作用域非常明确：前者只影响通过「Tasks: Run Task」触发的构建命令，后者只影响「Start Debugging」启动的调试进程。它们**不会修改集成终端的环境，也不会影响 Python 插件启动的 lint/test/kernel 进程**。
-
tasks.json示例中若写"env": {"PATH": "/my/bin"}，会覆盖整个原始PATH，正确写法是"PATH": "${env:PATH}:/my/bin" -
launch.json的env不会影响python.defaultInterpreterPath，后者只决定解释器位置，不传递运行时变量 - 想让所有 Python 相关操作（包括 lint、test、jupyter）都看到变量？唯一通用方式是：把变量设进 Python 环境本身（见第二部分），或统一通过
.vscode/settings.json注入终端环境（如"terminal.integrated.env.osx"）
真正容易被忽略的点是：VSCode 的「环境变量」从来不是单一体系，而是分层叠加的——shell 启动环境、GUI 登录环境、Python 虚拟环境、VSCode 自身配置、调试/任务配置……每层都可能覆盖或屏蔽上一层。不要试图找“一个开关”，要按实际使用场景（终端运行？调试？Jupyter？）分别补全。
