VSCode 1.84+ 已彻底弃用terminal.integrated.shell及shellArgs配置，必须删除；改用terminal.integrated.profiles.*和defaultProfile.*，否则Shell集成失效、图标不显示、命令状态丢失。
terminal.integrated.shell 相关配置已弃用，删掉它
VSCode 1.84+ 版本彻底移除了 terminal.integrated.shell 和 terminal.integrated.shellArgs 这两个旧配置项。如果你的 settings.json 里还留着它们，VSCode 不会报错，但会导致 Shell 集成无法正常初始化——图标不显示、Ctrl+R 失效、命令状态标记（✓/✗）消失。这类配置常见于老项目迁移或从网上复制的过时教程。
检查并删除以下内容：
"terminal.integrated.shell.windows""terminal.integrated.shell.osx""terminal.integrated.shell.linux""terminal.integrated.shellArgs.*"
改用现代配置方式：只保留 terminal.integrated.profiles.* 和 terminal.integrated.defaultProfile.*，否则 Shell 集成底层通信链路会被静默绕过。
Shell 集成脚本未加载？确认 source 行是否写在正确位置
启用 Terminal > Integrated: Shell Integration 只是开关，真正起作用的是 VSCode 提供的钩子脚本（如 code-shell-integration.zsh）。它必须被 Shell 启动时**首次读取**，否则后续所有功能（命令计时、目录跟踪、退出码捕获）都失效。
常见错误包括：
- 把
source行写在~/.zshrc末尾，但该文件里已有cd ~或cd /some/path—— 这类命令会提前触发 Shell 初始化，导致集成脚本加载前环境已被污染 - 用
[[ -f ... ]] && source ...判断路径，但 VSCode 安装路径含空格（如Visual Studio Code.app），而 shell 默认不支持带空格路径的source，需加引号：[[ -f "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code-shell-integration.zsh" ]] && source "/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code-shell-integration.zsh" - 在
~/.zshenv中调用source——.zshenv被非交互式 Shell 也读取，而 Shell 集成脚本只应在交互式会话中运行，否则可能报错中断
终端图标没出现？检查是否被 profile 键名冲突覆盖
VSCode 的 Shell 集成依赖终端进程启动时注入的环境变量（如 VSCODE_SHELL_INTEGRATION）。如果 terminal.integrated.profiles.* 中定义的 profile 键名和内置默认 profile 冲突（比如 macOS 上自定义了 "zsh"，但 VSCode 内置也叫 "zsh"），你的配置会被忽略，脚本不会注入。
验证方法：
- 打开终端，执行
echo $VSCODE_SHELL_INTEGRATION，输出应为1；为空则未注入 - 在设置中搜索
terminal.integrated.profiles.osx（macOS）或对应平台字段，确保键名不与内置重复（可改用"zsh-integrated"这类唯一名称） - 修改后必须完全退出 VSCode（不是重载窗口），再重新打开，否则 profile 缓存不刷新
重置后仍不生效？优先排查扩展干扰和开发者工具报错
某些终端增强类扩展（如 Terminal Tabs、Shell Launcher）会劫持终端创建流程，导致 Shell 集成的初始化钩子被跳过。这不是配置问题，而是运行时拦截。
快速诊断步骤：
- 用
Developer: Reload Window With Extensions Disabled重载窗口，再开终端看图标是否出现 - 打开开发者工具（
Developer: Toggle Developer Tools），切到 Console 标签，执行终端时观察是否有Failed to load code-shell-integration.*或ENOTDIR类错误 - 若报
ENOENT，说明脚本路径不存在——别信网上抄的固定路径，用find /Applications -name "code-shell-integration.zsh" 2>/dev/null实际查找
最易被忽略的一点：Shell 集成脚本必须由 VSCode **启动的同一个 Shell 进程**加载。如果你在 ~/.zshrc 里写了 exec fish 或 exec bash，那 zsh 只是跳板，真正运行的是 fish/bash，而集成脚本只对 zsh 生效——此时需为 fish 或 bash 单独配置对应脚本路径和 source 行。
