VSCode终端profile名称修改需清缓存并统一配置源：执行“Developer: Reset User Data”清除storage.json缓存，重启后在settings.json中统一定义terminal.integrated.profiles.*的name字段，避免用户/工作区/远程设置冲突，且必须配合-path和-args确保shell正确加载。
terminal.integrated.profiles.* 配置被缓存或覆盖
VSCode 的终端别名（比如 bash、zsh、PowerShell 在下拉列表里显示的名称）由 terminal.integrated.profiles.* 设置控制，但这些配置不会实时生效——一旦你改过 settings.json 里的 profile 名称，VSCode 可能仍沿用旧缓存，尤其是当你之前通过「Select Default Profile」点选过某项后，它会把选择结果写进 storage.json，优先级高于 settings。
- 打开命令面板：
Ctrl + Shift + P（Windows/Linux）或Cmd + Shift + P（macOS） - 输入并执行：
Developer: Reset User Data（该命令会清空storage.json和 UI 状态缓存，不影响settings.json或插件） - 重启 VSCode，再打开终端面板，点击「启动配置文件」下拉箭头 → 重新选择默认项
注意：仅修改 "terminal.integrated.profiles.linux" 或 "terminal.integrated.profiles.osx" 里的 "name" 字段，不重启或不清 storage，大概率看不到变化。
profile name 改了但终端下拉列表没更新
常见原因是 VSCode 已在 keybindings.json 或插件（如 GitLens、Shell Launcher）中注册了同名 profile，或者你在多个作用域（用户 / 工作区 / 远程）设置了冲突的 profiles。VSCode 会合并这些配置，但只取第一个合法定义的 name 值。
- 检查所有作用域：按
Ctrl + ,打开设置界面 → 右上角切换「User」「Workspace」「Remote」标签，搜索terminal.integrated.profiles - 确认没有重复定义，例如工作区 settings 里写了
"terminal.integrated.profiles.osx": { "zsh": { "name": "Zsh (Legacy)" } }，而用户 settings 里也定义了同 key 的"zsh" - 删除工作区或远程设置中冗余的 profile 定义，只保留一处清晰定义
别指望靠删 settings.json 里某几行就能“重置别名”——profile 名称是组合生效的，必须统一源头。
终端启动后自动执行 cd 或 alias 导致别名失效
VSCode 终端本身不管理 shell 内部的 alias，它只负责启动进程。如果你在 ~/.zshrc 或 ~/.bashrc 里定义了 alias code='code --no-sandbox' 这类，但终端启动后运行 which code 发现没生效，问题不在 VSCode，而在 shell 初始化流程被跳过或中断。
- 检查 shell 配置文件是否含
return或exit提前退出（尤其 macOS 的.zshrc开头常见[[ -f ~/.zprofile ]] && return） - 确认 VSCode 启动终端时加载的是 login shell 还是 non-login shell：Linux/macOS 默认是 non-login，不会读
~/.zshrc；可强制设为 login："terminal.integrated.shellArgs.osx": ["-l"] - 不要在配置里写
"terminal.integrated.shell.linux": "/usr/bin/zsh -i"——-i是交互式标志，不是初始化标志，且已被弃用
alias 不生效，90% 是 shell 没读到你的 rc 文件，和 VSCode 的 profile name 设置无关。
重命名 User 目录后 terminal profile 仍不对
这是最常被忽略的一点：重命名 User 目录确实会重建 settings.json 和 keybindings.json，但 terminal.integrated.profiles.* 是内置默认值，除非你显式覆盖，否则新目录里压根不会有这行配置。也就是说，重置后你看到的「bash」「zsh」等名称，是 VSCode 自带的硬编码 fallback，不是从旧配置恢复的。
- 若你想要自定义别名（比如把
zsh显示为? Zsh），必须手动加进新settings.json： "terminal.integrated.profiles.osx": { "zsh": { "path": "zsh", "name": "? Zsh" } }- Windows 用户注意：
terminal.integrated.profiles.windows中的name必须和 PowerShell/Git Bash 实际可执行路径匹配，否则下拉列表里根本不会出现该项
别假设重命名 User 就等于“终端设置也清零”——它只是没了你的定制，但 VSCode 自己的 profile 映射逻辑照常运行，而那个逻辑不支持 emoji 别名自动继承。
