psql交互模式的高效操作，很大程度依赖readline提供的行编辑能力。历史记录默认写入用户目录下的.psql_history，自动补全则通过查询数据库的系统表动态生成候选词。这两项功能在Linux和macOS上大多数构建版本直接可用，在Windows上则取决于安装包是否带readline支持。遇到上下键乱码或Tab不补全，通常都是终端、配置或连接状态不匹配导致的。

历史命令的存储、查看与搜索

psql历史记录默认存放在用户目录的.psql_history文件，Linux和macOS下是~/.psql_history，Windows通常在%APPDATA%\postgresql\psql_history，也就是C:\Users\你的用户名\AppData\Roaming\postgresql\psql_history。文件以纯文本方式保存，每条命令一行。如果忘了文件位置，可以在psql里执行\set HISTFILE查看当前值。写入时机不是实时的，正常退出会话时才会写入，异常终止可能丢失最近几条。

在交互模式下，上下方向键和Ctrl+P、Ctrl+N可以翻阅历史，Ctrl+R则进入反向增量搜索，按几次Ctrl+R会继续向前匹配更早的命令。\s命令可以列出当前会话的历史记录，也可以接文件路径把历史保存到指定位置，比如\s /tmp/my_queries.sql。如果只想清空历史，Linux或macOS下可以使用\s /dev/null，Windows下可以使用\s NUL。

历史条数默认是500条，可以用\set HISTSIZE 5000调整。还可以设置HISTCONTROL忽略重复或空白，比如\set HISTCONTROL ignoredups。如果希望历史保存在其他位置，在psql 14及以上版本可以\set HISTFILE /path/to/history。这些配置可以放进.psqlrc，每次启动自动生效。

\set HISTSIZE 5000
\set HISTCONTROL ignoredups
\set HISTFILE ~/.psql_history_custom
\s /tmp/session_history.sql

自动补全的触发条件与能力边界

psql的Tab补全不是简单的静态字典，而是在按下Tab时向服务器发起元数据查询，从pg_class、pg_attribute、pg_proc等系统表里生成候选列表。因此只有在连接成功、事务状态正常、且当前用户对相关系统表有查询权限时，补全才会完整。未连接数据库时，psql仍能补全反斜杠命令、数据库名称和部分配置项，但补不全业务表名和字段名。

补全范围包括SQL关键字、模式名、表名、视图名、物化视图名、列名、函数名、序列名、角色名等。例如输入SELECT * FROM ord按下Tab，会补成orders；如果给表起了别名o，输入SELECT o.再按Tab，就会列出orders表的所有列。还支持部分上下文理解，比如INSERT INTO table_name (会触发列清单补全，ALTER TABLE后补表名，\d后补对象名。大小写由COMP_KEYWORD_CASE变量控制，可以preserve、upper、lower，例如\set COMP_KEYWORD_CASE lower会让关键字补全成小写。

补全也有一些限制。如果search_path里没有目标模式，或者对象被锁、存在大量同名前缀对象，Tab响应会变慢甚至不出现候选。跨库对象无法补全，因为psql每个连接只在一个数据库中。若使用\c切换数据库但变量缓存失效，也可能导致补全短暂异常。在超大数据库中，补全查询可能跑几百毫秒，必要可以调整search_path，减少不必要模式的扫描。

用.psqlrc把常用配置固化下来

每次打开psql都手动设置历史大小、补全大小写、null显示等并不现实，推荐写入.psqlrc。Linux和macOS下文件是~/.psqlrc，Windows下通常是%APPDATA%\postgresql\psqlrc.conf，也可以设置PSQLRC环境变量指定其他路径。psql启动时会自动执行该文件中的反斜杠命令。更改后需要重新连接psql才会生效。

\set QUIET 1
\set HISTSIZE 10000
\set HISTCONTROL ignoredups
\set COMP_KEYWORD_CASE preserve
\pset null '(null)'
\pset pager off
\timing on

上面配置中，QUIET减少启动输出；HISTSIZE增大历史容量；HISTCONTROL去除重复命令；COMP_KEYWORD_CASE保持关键字大小写，便于统一风格；null用(NULL)表示空值；pager关闭可以避免结果分页干扰复制；timing会打印每条SQL的执行时间。这些都是日常交互中比较实用的设置。

如果希望readline层面的补全更符合习惯，比如忽略大小写、有歧义时直接列出全部候选，可以配置~/.inputrc文件。下面几个选项会作用于所有使用readline的工具，包括psql、bash等。需要重新打开终端或执行bind -f ~/.inputrc让配置生效。注意在Windows上只有使用readline构建的psql才支持这些；若用的是普通win32控制台构建，可能只提供基础历史与补全，行为会有差异。

set completion-ignore-case on
set show-all-if-ambiguous on
set show-all-if-unmodified on

常见故障与排查思路

如果发现psql退出后历史没有写进去，先检查HISTSIZE是否被设为0，或者HISTFILE指向了一个无写入权限的路径。某些终端中异常关闭窗口可能导致最后的命令来不及写入，正常使用Ctrl+D或\q退出比较可靠。如果多个psql实例同时写一个历史文件，也可能出现交错或覆盖，必要时给不同项目设置不同的HISTFILE。

Tab补全不出现时，可以先确认是否已经连接数据库。若连接正常但补全候选还是空，可以检查当前search_path：SHOW search_path;。如果目标表在public之外的模式且没有纳入路径，psql不会自动列出。还可以查看是否有权限读取系统表，个别云数据库会限制pg_catalog的访问范围，补全就会部分失效。此时可以尝试SELECT 1 FROM pg_class LIMIT 1;确认基础查询是否正常。

SHOW search_path;
SELECT 1 FROM pg_class LIMIT 1;

出现上下键显示乱码或Ctrl+R没反应，通常和终端模拟器、TERM变量或输入法冲突有关。可以换用稳定终端，或检查stty -a中终端行规程是否正常。Windows下建议使用带readline支持的安装包，或改用更完整的终端工具，以获得接近Linux的psql交互体验。掌握历史命令和补全配置之后，日常查询、维护和脚本调试效率会有明显提升。