不同项目需用工作区级.vscode/settings.json绑定终端profile与启动脚本（如activate.sh），配合cwd、env.*和direnv，才能确保Node.js版本、Python虚拟环境、PATH等按项目自动隔离加载。
不同项目需要独立终端环境，不是靠改全局设置，而是必须用工作区级配置 + 启动脚本组合实现。只设 terminal.integrated.env.* 或只改 shell profile 都会漏掉关键环节——比如 Node.js 版本切换失败、Python 虚拟环境没激活、PATH 没更新。
用 .vscode/settings.json 绑定项目专属终端行为
每个项目根目录下建 .vscode/settings.json，写入终端启动路径和环境变量，这是隔离的第一层：
-
"terminal.integrated.cwd"必须设为"${workspaceFolder}"或其子路径（如"${workspaceFolder}/backend"），否则新开终端总在用户家目录或上一个项目的路径里启动 -
"terminal.integrated.env.linux"（或.osx/.windows）可注入项目级变量，比如"NODE_ENV": "test"、"DATABASE_URL": "sqlite:///dev.db"，但注意：这些变量只影响终端进程本身，不执行命令（比如不会自动source venv/bin/activate） - 不要把
terminal.integrated.defaultProfile.*写在用户 settings 里——它会被所有项目共用，必须放在工作区settings.json中才生效
用 source 启动脚本加载运行时环境
光靠环境变量不够，nvm/pyenv/venv 这类工具需要实际执行命令才能切换上下文。推荐在项目中放一个可执行脚本，由终端 profile 调用：
- 脚本位置建议为
.vscode/activate.sh（Linux/macOS）或.vscode/activate.ps1（Windows），内容例如：nvm use 18.17.0 > /dev/null<br>python -m venv .venv --upgrade-deps 2>/dev/null || true<br>source .venv/bin/activate
- 确保脚本有执行权限：
chmod +x .vscode/activate.sh - 在
.vscode/settings.json中定义 profile："terminal.integrated.profiles.linux": {<br> "Project Shell": {<br> "path": "bash",<br> "args": ["-i", "-c", "source .vscode/activate.sh && exec bash"]<br> }<br>},<br>"terminal.integrated.defaultProfile.linux": "Project Shell" -
-i是关键：让 bash 读取~/.bashrc，避免因非交互模式导致 nvm/pyenv 初始化失败
别忽略终端分栏与复用的陷阱
很多人以为“开了多个终端标签页=多个独立环境”，其实分栏终端默认继承父终端的当前路径（pwd），而不是项目根目录：
- 右键某个终端选
Split Terminal，新终端的起始路径 = 原终端当前所在目录，不是terminal.integrated.cwd设置值 - 想让每个分栏都从项目根目录启动？不能依赖分栏行为，得统一用上面的 profile 方案——只要 profile 固定了启动逻辑，无论怎么分栏，新终端都会先执行
activate.sh -
terminal.integrated.enablePersistentSessions设为true后，关掉终端标签页只是隐藏，进程仍在后台跑。如果里面起了npm run dev，你根本看不到，端口还会被占——必须手动进对应终端按Ctrl+C或输kill %1
macOS/Linux 用户优先考虑 direnv
如果你用 zsh/fish，direnv 比手写 activate.sh 更静默可靠：
- 安装后在
~/.zshrc加eval "$(direnv hook zsh)"，再在项目根目录建.envrc，内容如：use nvm 18.17.0<br>layout python3<br>export API_BASE_URL="https://staging.example.com"
- VSCode 终端只要基于你的 shell 启动（比如 profile 设的是
zsh），就会自动触发direnv allow并加载变量 - 优势是离开项目目录时自动清理环境，且不依赖 VSCode 配置——终端、iTerm、tmux 全部同步生效
- 缺点：Windows 不原生支持，PowerShell 用户需额外装
direnv-powershell，且兼容性不稳定
真正难的不是配出一个能跑的终端，而是让每次新开、分栏、重启 VSCode 后，环境都一致且可预期。最容易被跳过的点是：没确认 VSCode 是以文件夹形式打开项目（右下角状态栏要显示「工作区」）、脚本没加 exec bash 导致终端退出后卡住、以及忘记给 activate.sh 加执行权限。
