在 macOS 上为 tlrc 配置中文显示一步一步解决 tldr 语言问题很多人在 macOS 上使用tldr或tlrc时会发现即使执行了tldr --update输出仍然只有英文页面。这通常不是更新失败而是因为客户端当前只安装了英文缓存中文页面并没有被加入到语言配置和本地缓存中。这篇文章记录一套更稳妥的解决方案先确认配置文件路径再生成默认配置接着把语言改成中文优先最后清空旧缓存并重新下载页面。第一步查看默认配置路径先在终端里执行下面这条命令tldr --config-pathtlrc官方文档说明这个命令会打印默认配置文件路径并在需要时创建配置目录因此它比手动猜路径更可靠。第二步生成默认配置文件执行下面这条命令把默认配置写入配置文件tldr --gen-config$(tldr --config-path)这里的重点是如果路径里有空格必须把整个路径用双引号包起来。双引号要从路径开头包到路径结尾而不是只包中间一段否则 shell 可能会把空格前后的内容当成不同参数。例如下面这种写法是正确的nano$HOME/Library/Application Support/tlrc/config.toml因为双引号包住了整个路径所以 shell 会把Application Support识别为同一个目录名而不是两个独立参数。下面这种写法就容易出错nano$HOME/Library/Application Support/tlrc/config.toml在这条错误示例里空格会让 shell 把路径拆开导致程序找不到目标文件。第三步打开配置文件并修改语言接下来用编辑器打开配置文件nano$(tldr --config-path)找到文件中的[cache]段把languages改成下面这样[cache] languages [zh, en]tlrc官方文档说明cache.languages用来指定要下载和使用的语言如果不显式设置客户端会改为参考环境变量。把它写成[zh, en]的等价 TOML 形式[zh, en]就表示优先使用中文同时保留英文作为后备。第四步保存文件并退出编辑器如果使用的是nano可以按下面顺序操作按Ctrl O保存文件。按Enter确认文件名。按Ctrl X退出编辑器。这一步只是把配置改写到磁盘中真正让中文页面生效还需要重新刷新缓存。第五步清理旧缓存并重新更新执行下面两条命令tldr --clean-cache tldr--update--clean-cache会删除旧缓存--update会根据当前配置重新下载页面。因为前一步已经把语言设为zh和en更新时客户端就会去拉取中文页面而不是只保留原来的英文页。第六步验证是否已经切换到中文最后运行一个常见命令测试例如tldrcp如果配置已经生效输出应优先显示中文内容如果某个页面暂时没有中文版本英文页面仍会作为后备继续可用。官方文档说明英文始终会被下载因此把en放在语言列表里是一个稳妥做法。常见错误总结这个问题反复出现通常是因为下面几种原因只执行了tldr --update但没有先在配置文件里加入zh所以客户端仍然只更新英文缓存。路径里有空格却没有用双引号包住整个路径导致 shell 把一个路径拆成多个参数。在 zsh 里把~放进双引号中例如~/Library/...这样~不会展开成家目录更稳妥的做法是直接使用$HOME。误以为tldr --update zh这种写法可以安装语言但--update并不是这样使用的语言应通过配置文件中的cache.languages来指定。可直接复制的完整命令如果只想快速完成配置可以直接按顺序执行下面这些命令tldr --config-path tldr --gen-config$(tldr --config-path)nano$(tldr --config-path)把配置文件中的内容改成[cache] languages [zh, en]然后继续执行tldr --clean-cache tldr--updatetldrcp完成这些步骤后tlrc就会优先显示中文页面同时保留英文作为兜底语言。这套方法的核心不在于反复更新缓存而在于先把语言配置写对再让客户端按新配置重新下载页面。