VSCode集成终端默认以非登录非交互模式启动shell，导致配置文件不加载、路径错乱、环境变量丢失；需在settings.json中配置-l参数启用登录shell，并通过Open Folder打开项目确保工作目录正确。

VSCode 的集成终端不是“开箱即用就高效”的工具，它默认行为常导致路径错乱、Shell 启动失败或环境变量丢失——关键在于你启动它的上下文和配置方式。

为什么 Ctrl+` 打开的终端不加载你的 shell 配置（如 ~/.zshrc 或 ~/.bash_profile）

VSCode 默认以非登录（non-login）、非交互（non-interactive）模式启动 shell，跳过大部分初始化文件。尤其在 macOS 和 Linux 上，zsh 会忽略 ~/.zshrc，除非显式指定为登录 shell。

• Windows 用户注意：PowerShell 默认走 $PROFILE，但 VSCode 可能用的是 pwsh -NoProfile 启动，导致自定义函数/别名失效
• 解决方法：在 settings.json 中强制启用登录模式：

  "terminal.integrated.profiles.linux": {
    "zsh": {
      "path": "zsh",
      "args": ["-l"]
    }
  }

  （-l 表示 login shell）
• macOS 用户若用 zsh，还需确认系统默认 shell 是 /bin/zsh（而非 /usr/bin/zsh），否则 VSCode 可能 fallback 到旧版本

如何让集成终端自动进入当前打开的文件夹（而不是用户主目录）

默认情况下，新终端会继承 VSCode 窗口的“工作区根目录”，但如果你没打开文件夹、只打开了单个文件，或使用了多根工作区，行为就会混乱。

• 确保你通过 File > Open Folder... 打开项目，而不是直接双击文件——这是最稳定触发路径继承的方式
• 检查设置项："terminal.integrated.cwd" 若被手动设为绝对路径（如 "~/projects"），会覆盖当前上下文，建议留空或设为 "${fileDirname}"（仅适用于从文件内触发终端）
• 快捷键 Ctrl+Shift+`（Windows/Linux）或 Cmd+Shift+`（macOS）可复用上一个终端，并保持其工作目录；而单纯 Ctrl+` 总是新建一个，默认回到工作区根

terminal.integrated.env.* 配置为什么有时不生效

环境变量注入有优先级：系统环境 process.env（父进程） terminal.integrated.env.*，但某些 shell 启动后会再次覆盖（比如 pyenv 或 nvm 的初始化脚本）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 不要在 env 里写 PYTHONPATH 这类会被后续脚本重写的变量；改用 shell 配置文件中 export
• Windows 上 terminal.integrated.env.windows 必须是对象格式：

  "terminal.integrated.env.windows": {
    "NODE_ENV": "development"
  }

  ，写成数组或字符串会静默失败
• 修改后需重启终端面板（关闭再 Ctrl+`），热重载不生效

多个终端标签页之间共享历史记录和命令补全吗

不共享。每个终端实例是独立进程，历史记录只保存在各自 shell 的内存中，关闭即丢失（除非 shell 自身配置了 HISTFILE 持久化）。

• 想跨终端复用命令？用 Ctrl+Shift+P → Terminal: Focus Terminal 再按 ↑，比切换标签更快
• 避免重复输入长命令：在终端里用 history | grep xxx 查找，或把高频命令做成 VSCode 任务（tasks.json），绑定快捷键
• 真正需要共享状态？考虑用 tmux 或 screen 在集成终端里启动，但这会增加心智负担，适合长期运行服务场景

最常被忽略的一点：VSCode 终端的“复制粘贴”行为受 terminal.integrated.copyOnSelection 和系统剪贴板权限双重影响，特别是 macOS 上首次粘贴可能失败——不是 bug，是沙盒限制，需要手动授权。