强迫症之保持干净的 $HOME 目录

前言

本人在生活中就是一个秩序敏感者，喜欢将桌面整理的井井有条，很享受简洁给我带来的安定感。

这种习惯也带入到使用电脑的场景，我所有文档都分类摆放在特定目录，在任何时候我都可以快速准确到找到需要的文件。

也会定期清理不重要的文件，让资源管理器处于轻松的状态。这算一种强迫症，喜欢删除认为不重要的东西，也反感应用软件在我非预期的地方放置文件。

到处拉屎的 .zsh

Oh My ZSH 对于程序员来说应该无需赘述，它非常优秀，是我愿意使用终端必要前提。但是它有个缺点，就是会在你的用户目录下生成很多意外文件。

比如在成功安装好 Oh My ZSH 之后，我预期的文件只有

$HOME/.oh-my-zsh
$HOME/.zshrc

但是事实是在我的用户目录下会额外生成如下文件：

.zprofile
.zsh_history // 输入历史
.zsh_sessions // 会话历史
.zcompdump // 加速自动补全
.zcompdump.zwc // 编译版本，进一步加速自动补全

是的，它就是这么随意。

强迫症的我每次看到这些不速之客都非常难受，因为它们都有自己的作用，且哪怕删除了下次启动又会自动生成。

于是就开始折腾如何收敛这些文件，好在可以在 .zshrc 中通过复写这些路径的变量，来达到收敛的目的。

sh 复制代码

export NODE_REPL_HISTORY="" # 关闭在终端中使用 node 的输入历史记录
export LESSHISTFILE=- # 关闭使用 less 命令的记录

# 在公共的缓存目录创建 oh-my-zsh 的缓存目录
export ZSH_CACHE_DIR="$HOME/.cache/oh-my-zsh"
mkdir -p $ZSH_CACHE_DIR

# 设置 zsh dump 的缓存文件
export ZSH_COMPDUMP="$ZSH_CACHE_DIR/.zcompdump"
# 设置 zsh 的历史记录文件
export HISTFILE="$ZSH_CACHE_DIR/.zsh_history"

# 设置 zsh 的 session 文件
# 当前设置无效，需要在 /private/etc/zshrc_Apple_Terminal 中设置
export SHELL_SESSION_DIR="$ZSH_CACHE_DIR/.zsh_sessions"
mkdir -p $SHELL_SESSION_DIR

这样就可以把那些临时文件都收敛到 $HOME/.cache 中，眼不见为净。

意外的发现

当我整理完 oh-my-zsh 的临时文件时，接着扫视 $HOME ，发现一个 .gk 的文件夹有点碍眼。

如何评判是否碍眼？

就是我觉得它不是常规软件生成的，只是个妃子，不配在 $HOME 拥有独立位置的文件。

比如我会觉得 .npmrc 和 .ssh 这种咖位的配置，直接存在于 $HOME是更容易接受的。（是的，是个严重的双标党）

于是开始谷歌这个 .gk 是干嘛的，搜到对应的 vscode-gitlens-issue 有人同样反感这个文件在 $HOME 里生成，建议作者采纳修改建议。

作者表示不想改，并且巴拉巴拉...

接着该用户搬出了一个社区的规范，并且列举了一些已经遵守该规范的 PR

于是我就发现了 XDG_Base_Directory 这个造福强迫症患者对人类文明进步做出贡献的规范。

XDG_Base_Directory

XDG_Base_Directory （Cross-Desktop Group）是一个由 freedesktop 发起的标准规范。定义了配置文件、数据文件、状态数据和缓存文件的存储路径，主要用于类 Unix/Linux 系统。

这套标准的目标是 减少 $HOME 目录的混乱 ，避免一堆 .* 文件（如 .bashrc、.gitconfig、.zsh_history）直接放置在 $HOME 里。

XDG 规范主要定义了以下 4 个环境变量：

变量	作用	适合存放的数据	示例
`XDG_CONFIG_HOME`	配置文件	用户的应用配置	`~/.config/git/config`
`XDG_CACHE_HOME`	缓存	可随时删除的数据	`~/.cache/zsh/`
`XDG_DATA_HOME`	用户数据	需要长期存储的数据	`~/.local/share/nvim/undo/`
`XDG_STATE_HOME`	应用状态数据	运行时状态、日志、历史记录	`~/.local/state/zsh/history`

所以正常情况下我们都需要在 .zshrc 里做如下配置：

sh 复制代码

# XDG Base Directory Specification https://wiki.archlinux.org/title/XDG_Base_Directory
export XDG_CONFIG_HOME="$HOME/.config"
export XDG_CACHE_HOME="$HOME/.cache"
export XDG_DATA_HOME="$HOME/.local/share"
export XDG_STATE_HOME="$HOME/.local/state"
# XDG Base Directory Specification end

如果应用程序跟进实现了此标准，那么在需要保存文件的时候，会优先读取 XDG- 对应的路径（用户自定义），否则回退到系统默认。

正常情况下都推荐将 XDG- 对应的路径设置为系统默认，即如上给出的配置示例。除非你有特别强烈的定制需求。

比如某个应用程序需要往磁盘写入一些缓存文件，那么应该按照如下方式实现：

js 复制代码

import { join } from 'path';
import { homedir } from 'os';

const XDG_CACHE_HOME = process.env.XDG_CACHE_HOME || join(homedir(), ".cache");

const applicationCachePath = join(XDG_CACHE_HOME, 'your-application-name')

虽然推荐应用按如上示例的优先级去获取路径，但是有些应用为了保持用户的习惯，在获取不到 process.env.XDG_CACHE_HOME 时，它是默认回退到 ~/.xxx。

比如 Git

$GIT_CONFIG_GLOBAL（如果设置了）
$HOME/.gitconfig
/etc/gitconfig（系统级别）

所以为了确保实现了 XDG_Base_Directory 规范的应用优先获取到 XDG- 路径，推荐都明确做好如下配置，确保命中第一优先级。

sh 复制代码

# XDG Base Directory Specification https://wiki.archlinux.org/title/XDG_Base_Directory
export XDG_CONFIG_HOME="$HOME/.config"
export XDG_CACHE_HOME="$HOME/.cache"
export XDG_DATA_HOME="$HOME/.local/share"
export XDG_STATE_HOME="$HOME/.local/state"
# XDG Base Directory Specification end

XDG_Base_Directory 维护了一个表格，将那些已经遵循该规范的应用列举在上面。

我截图了部分，有兴趣的同学可以点击链接进行查看。