VSCode本身不保存终端历史会话,所谓“恢复失败”实为shell未持久化存储或VSCode启动绕过shell历史机制;需检查terminal.integrated.profiles.*是否含-NoProfile/-c参数、HISTFILE路径是否可写、terminal.integrated.cwd是否指向无权目录,并确保shell配置文件正确加载PSReadLine或histappend等设置。

VSCode 本身不保存终端历史会话,所谓“恢复失败”,其实是 shell 没存住、或者 VSCode 启动时绕过了 shell 的历史机制。重置不是去修 VSCode,而是让 shell 重新获得写历史、读历史的能力。
terminal.integrated.profiles.* 配置错误导致历史模块不加载
PowerShell 启动带 -NoProfile、bash/zsh 被强制用 -c 执行命令,都会跳过 .bashrc 或 $PROFILE —— 这意味着 PSReadLine、HISTFILE、histappend 全部失效。
- 检查
settings.json中是否含"args": ["-NoProfile"]或"args": ["-c", "xxx"]这类配置,直接删掉整条terminal.integrated.profiles.*配置项 - Windows 下 PowerShell 默认 profile 路径是
$PROFILE,运行notepad $PROFILE确认文件存在且含Import-Module PSReadLine - Linux/macOS 下检查
~/.bashrc是否有export HISTFILE=~/.bash_history和shopt -s histappend
终端工作目录(terminal.integrated.cwd)被设为临时路径
如果 terminal.integrated.cwd 指向一个无写权限的路径(如 /tmp 或只读挂载点),shell 就无法将命令追加进 HISTFILE,历史文件始终为空。
- 在设置中搜索
terminal.integrated.cwd,清空该字段或设为"${workspaceFolder}"(确保项目目录可写) - 打开新终端后立即执行
echo $HISTFILE(bash/zsh)或$env:HISTFILE(PowerShell),确认路径指向用户主目录下可写位置 - 手动测试:运行
echo "test" >> ~/.bash_history,再cat ~/.bash_history看是否成功写入
VSCode 启动方式绕过用户环境(code --user-data-dir 或远程开发)
用 code --user-data-dir=/tmp/test 启动,或通过 Remote-SSH/WSL 连接时未加载用户 shell 配置,会导致所有历史相关变量(HISTFILE、HISTSIZE)回归默认值,且不持久。
- 避免用临时
--user-data-dir启动日常开发环境;如必须使用,启动后手动运行source ~/.bashrc补全历史配置 - Remote-SSH 场景下,在远程服务器的
~/.bashrc或~/.zshrc中显式启用INC_APPEND_HISTORY和SHARE_HISTORY - 检查 VSCode 底部状态栏右下角显示的终端类型,如果是
bash (login shell),说明已加载 profile;若只写bash,大概率没走 login 流程
真正关键的不是“重置 VSCode”,而是确认 shell 进程启动时有没有读到你的历史配置——每次新开终端都是全新 shell 进程,它不会继承前一个 tab 的内存,只认磁盘上的 HISTFILE 和启动时加载的 rc 文件。任何试图让 VSCode “记住终端输入”的方案,本质上都在和 shell 抢控制权,而它永远赢不了。


















