VSCode终端不读~/.zshrc或~/.bashrc是因为默认以非登录shell启动，需在settings.json中配置"terminal.integrated.shellArgs.osx": ["-l"]（macOS）或"terminal.integrated.shellArgs.linux": ["-l"]（Linux），改后须彻底退出VSCode、关闭所有终端面板并新建终端才生效。
VSCode终端不读~/.zshrc或~/.bashrc怎么办
VSCode集成终端默认启动的是「非登录 shell」，跳过了你日常用的~/.zshrc或~/.bashrc——所以哪怕你在那里写了export PATH="/opt/homebrew/bin:$PATH"，终端也根本不会执行它。
解决办法是强制终端以登录模式启动：
- macOS：在
settings.json里加"terminal.integrated.shellArgs.osx": ["-l"] - Linux：对应加
"terminal.integrated.shellArgs.linux": ["-l"]（部分zsh需用["--login"]） - Windows PowerShell：需先运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，再确保shellArgs包含-NoExit -Command ". $PROFILE"（如果$PROFILE里有环境设置）
改完必须关闭所有已打开的终端面板，再新建一个才生效——旧终端进程不会自动重载配置。
launch.json里设了env但Python脚本还是拿不到变量
调试器（F5）和终端是两个完全隔离的环境：launch.json里的env只对调试进程生效，不影响你在终端里跑的python script.py，也不影响Jupyter kernel。
常见错误写法：
- 把
env写在configurations外层（应该嵌套在每个configuration对象内部） - 用错字段名，比如写成
environment（旧版字段，已弃用） - 拼接
PATH时漏掉${env:PATH}，导致整个PATH被覆盖
正确示例：
{
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "pytest",
"env": {
"HF_HOME": "/Users/me/.cache/huggingface",
"PATH": "${env:PATH}:/opt/homebrew/bin"
}
}
]
}
改了系统环境变量，VSCode重启后终端还是旧PATH
VSCode是GUI应用，启动时继承的是桌面会话的初始环境，不是你当前终端的环境。你在终端里export PATH=...，只影响那个终端及其子进程；双击图标启动的VSCode完全看不到。
可靠做法分平台：
- macOS：把环境变量写进
~/.zprofile（不是~/.zshrc），然后重启VSCode或从终端执行code . - Linux：写进
~/.profile，同样需重启VSCode或用code .从已配置好的终端启动 - Windows：必须通过「系统属性 → 高级 → 环境变量」设置系统级或用户级变量，改完要重启VSCode（仅重启窗口不够，得彻底退出进程）
别依赖「修改注册表后点确定就生效」——Windows资源管理器和VSCode进程不会动态刷新环境块，必须重启进程。
为什么os.getenv("XXX")在Python里返回None
根本不是Python或VSCode的问题，而是Python进程压根没拿到那个变量。VSCode的Python调试器、Jupyter kernel、测试运行器，三者加载环境的路径完全不同：
- 调试器：只认
launch.json里的env - Jupyter kernel：只认
ipykernel启动时注入的变量，或conda env config vars set写死的值 - 直接运行脚本（
python xxx.py）：只继承终端当前环境，和launch.json无关
最稳的通用解法是把变量绑定到Python环境本身：
- Conda用户：
conda env config vars set HF_HOME=/path/to/hf，然后conda deactivate && conda activate myenv - venv用户：编辑虚拟环境下的
bin/activate（macOS/Linux）或Scripts/activate.bat（Windows），在末尾追加export HF_HOME=...或set HF_HOME=...
硬编码在launch.json或settings.json里，永远只能覆盖某一条执行路径——而真实项目往往同时走调试、终端运行、Jupyter三路，漏掉任何一路都会出问题。
