VSCode无原生多租户功能，需通过Profile+Env Switcher+dotenv组合实现：Profile隔离扩展与设置，Env Switcher切换.env.tenant-*文件，dotenv注入环境变量；launch.json须用envFile而非硬编码env，且需信任工作区以启用租户专用扩展。
多租户开发环境 ≠ VSCode 原生功能
VSCode 本身不识别“租户”概念，所有所谓“多租户开发环境”都是靠扩展 + 配置组合实现的。你不能指望装一个插件就自动切换 tenant-a 和 tenant-b 的 API、数据库、Feature Flag——它只提供能力管道，具体怎么接，得你自己搭。
核心扩展选型：Profile + Env Switcher + dotenv
真正能落地的组合只有三个扩展协同工作：
-
Azure Account：用于绑定 Entra ID 多租户身份，让DefaultAzureCredential能自动读取当前登录上下文（尤其在访问 Key Vault 或 App Configuration 时） -
Settings Sync或Profile（VSCode v1.80+ 内置）：每个 Profile 可独立挂载settings.json、launch.json和扩展列表。比如tenant-prodProfile 自动启用ms-vscode.vscode-typescript-next，而tenant-stagingProfile 则禁用它 -
Environment Variables Switcher或dotenv：管理.env.tenant-a、.env.tenant-b这类文件，并通过命令面板触发Env: Switch Environment实时注入进程环境变量
注意：Environment Variables Switcher 不会修改系统级环境变量，只影响当前 VSCode 窗口启动的终端和调试会话。如果 Node.js 启动脚本里用了 process.env.API_BASE_URL，它必须在 Env: Switch Environment 执行后才生效。
调试时租户配置失效的常见原因
即使 Profile 切对了、.env 文件也加载了，launch.json 仍可能绕过环境变量：
-
env字段写死覆盖了动态注入值，例如："env": {"API_BASE_URL": "https://dev.api.example.com"}—— 删除或改用envFile -
envFile指向错误路径，比如写成"./.env"而不是"./.env.tenant-a"；VSCode 不会自动补全租户后缀 - 调试器启动的是子进程（如 Jest、Webpack Dev Server），它们不继承父进程的
process.env，需显式传递："env": { ... }, "runtimeArgs": ["--env", "TENANT=tenant-a"]
最稳妥的做法是在 launch.json 中用变量引用："envFile": "${workspaceFolder}/.env.${config:tenantName}"，再配合 settings.json 里定义 "tenantName": "tenant-a"。
Profile 切换后扩展没更新？检查 workspace trust
VSCode 在打开新文件夹时会询问是否信任该工作区。如果不信任，Profile 绑定的扩展（比如某个租户专用的 GraphQL 插件）会被禁用，且不会提示你——它只是静默跳过。
验证方式：Ctrl+Shift+P → 输入 Developer: Toggle Developer Tools → 查看 Console 是否有 Extension 'xxx' is disabled due to workspace trust 报错。
解决办法：点击右下角锁形图标 → 选择 Allow Workspace Trust，或者在 settings.json 中设 "security.workspace.trust.untrustedFiles": "open"（仅限内网可信环境）。
Profile 是状态容器，不是魔法开关；环境变量、调试配置、扩展启用状态、甚至终端启动路径，都得各自对齐，漏掉一环，租户就“切丢了”。
