在 macOS 上为 tlrc 配置中文显示：一步一步解决 tldr 语言问题
在 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就会优先显示中文页面，同时保留英文作为兜底语言。这套方法的核心不在于反复更新缓存，而在于先把语言配置写对，再让客户端按新配置重新下载页面。