xshell 如何开启 shell 历史记录

在 Xshell 中查看之前输入的命令，主要依靠远程 Shell 的历史功能；想把屏幕上的输出也保存下来，则需要 Xshell 会话日志。下面以 Windows 版 Xshell 连接 Linux 上的交互式 Bash 为例，先开启并验证命令历史，再说明日志的入口。

整套操作在自己的远程测试账号中完成。历史设置与账号、Shell 和服务器环境有关，更换账号或连到另一台主机后，应重新检查，不能只看 Xshell 窗口是否相同。

在Xshell终端中检查Bash版本及交互式状态标志

1. 确认已经进入交互式 Bash

连接目标 SSH 会话并登录后，在远程提示符输入：

printf 'Bash=%s\nflags=%s\n' "${BASH_VERSION-}" "$-"

查看实际返回。Bash 版本信息为空时，先确认当前使用的 Shell；本篇后面的 Bash 配置不直接用于 zsh、fish 或其他解释器。flags 中应能看到代表交互式状态的 i，普通脚本进程也不应直接当成日常登录终端处理。

交互式 Bash 通常默认开启命令历史。如果一直看不到旧命令，需要继续检查历史开关、容量、保存文件和过滤规则，而不是在 Xshell 中寻找一个通用于所有服务器的“开启历史”按钮。

此时先输入 history 10，查看当前会话最近的记录。能显示当前命令，只代表内存里的历史可用，尚不能证明断开连接后仍会保存。

2. 查看原设置，再启用缺失的历史功能

先查看当前配置，保留这些值作为调整前的记录：

printf 'HISTSIZE=%s\nHISTFILE=%s\nHISTFILESIZE=%s\n' "${HISTSIZE-}" "${HISTFILE-}" "${HISTFILESIZE-}"
printf 'HISTCONTROL=%s\nHISTIGNORE=%s\n' "${HISTCONTROL-}" "${HISTIGNORE-}"

HISTSIZE 决定内存中保留多少条命令；HISTFILE 指定落盘文件；HISTFILESIZE 控制历史文件容量。容量为 0、历史文件路径为空或不可写，都可能使保存结果不符合预期。

打印HISTSIZE、HISTFILE等历史配置变量的当前值

先把已有历史文件复制到单独的备份位置，再在当前交互式 Bash 中执行下面的设置。示例只为缺失或零值配置补上可用值，原有的非零容量和非空路径保持原值：

set -o history
if [[ ${HISTSIZE:-0} == 0 ]]; then HISTSIZE=10000; fi
if [[ -z ${HISTFILE:-} ]]; then HISTFILE="$HOME/.bash_history"; fi
if [[ ${HISTFILESIZE-} == 0 ]]; then HISTFILESIZE=20000; fi
shopt -s histappend

其中，set -o history 开启历史功能；histappend 使退出时采用追加方式保存，减少不同会话把历史文件整体覆盖的情况。它不等于所有已打开窗口都会即时共享同一份内存历史。

如果账号配置把变量设为只读，或服务器有统一的历史策略，应按实际权限处理，不能通过更换账号绕过管理要求。也不要随意把已有较大的容量调小，缩小 HISTFILESIZE 可能截去较早记录。

3. 输入一条标记命令，验证内存与磁盘两层结果

在当前终端输入一条容易辨认、没有敏感信息的测试命令：

printf 'history-check\n'
history 10
history -a

在 history 10 的实际输出中找到这条测试命令，再观察 history -a 是否报错。history -a 用于把当前会话尚未追加的新记录写入历史文件，不会替你恢复已经丢失的旧记录。

如果测试命令没有出现，检查 HISTCONTROL 与 HISTIGNORE。比如 ignorespace 会忽略以空格开头的命令，ignoredups 会忽略紧邻的重复项；HISTIGNORE 还可以过滤匹配的命令。应按实际需要调整，不能只因为某一条被过滤，就认定所有历史都没开启。

写入报权限错误时，检查 HISTFILE 是否指向自己账号能够写入的文件，以及父目录是否存在。保留原错误信息，不要直接把文件和目录改成全员可写。

历史文件可能包含曾经输入的命令参数，不应把它整份发到公开讨论区。验证时使用上面的普通标记即可，不需要拿密码或访问令牌做测试。

3. 输入一条标记命令，验证内存与磁盘两层结果

4. 把设置放进实际会读取的启动文件

前面的设置作用于当前 Bash 会话。希望新登录后继续生效，应先备份自己的启动文件，再把已验证的设置加入对应文件，保留文件中原有的其他内容。

交互式、非登录 Bash 通常读取 ~/.bashrc。登录式 Bash 先读取 /etc/profile，再依次查找 ~/.bash_profile、~/.bash_login 和 ~/.profile，并读取其中首个存在且可读的文件。因此，不能假设每次 SSH 登录都会自动执行 ~/.bashrc。

常见做法是在 ~/.bashrc 中维护交互配置，并在实际使用的个人登录启动文件中确认已有类似下面的读取语句；没有时，再根据自己的环境加入，避免重复加载：

if [ -f ~/.bashrc ]; then
    . ~/.bashrc
fi

不要为了历史功能把整个 .bashrc 或 .bash_profile 覆盖成几行示例，也不要修改全体用户共用的配置来代替个人配置。完成后保留当前连接，再新开一个到同一主机、同一账号的 SSH 会话验证，避免只在旧会话中检查。

在.bashrc中添加历史配置并确保被登录脚本引用

5. 新开会话后查找标记，确认确实保存

在新连接的 Bash 中再次输入 history 10，查找此前的 history-check 命令，并核对 HISTFILE 与历史容量是否符合预期。

旧连接中的新命令不一定已经写入文件，可先在旧会话执行 history -a，再在新会话使用 history -n 读取本会话尚未读入的新记录。不要反复使用覆盖写入命令来试图同步窗口。

如果新连接读不到记录，按顺序检查：是否换了账号或主机、启动文件是否真正加载、历史文件是否可写，以及命令是否被过滤。只有新会话能读取已经保存的标记，才说明本次持久保存验证完成。

该功能保存的是 Shell 命令历史，不是逐行完整的命令输出，也不是不可修改的审计记录。需要排查程序输出时，继续使用下一步的会话日志。

6. 需要保存输出时，另开 Xshell 日志

在 Windows 版 Xshell 中，打开【文件】→【日志】→【开始】，选择本地日志文件名和保存位置。只需要普通文字时，按日志窗口的选项关闭同时记录终端控制代码，再保存。

通过Xshell菜单【文件】-【日志】-【开始】开启本地会话日志

日志记录的是启用后的终端会话内容，文件存放在 Windows 本地；Bash 历史则位于远程账号环境。两者可以配合使用，但开启本地日志不会自动修改服务器上的 HISTFILE。

用一条普通测试命令确认日志确实写入，再按当前界面的日志停止入口结束记录，打开本地文件查看。最后保留个人启动配置的备份和必要测试结果，今后按同一账号、同一 Shell 的实际环境维护即可。