升级至Org-mode 9.4.6后，如何恢复org-store-link/org-insert-link以标题为链接描述的旧行为？

我刚好碰到过这个问题，Org-mode 9.4.x版本确实调整了带CUSTOM_ID标题的链接生成逻辑——默认会把「文件完整路径::#custom-id」作为链接描述，而不是咱们习惯的标题文本。不过要恢复旧行为很简单，给你两个方案：

方案1：设置org-link-descriptive变量（推荐） #

这是最省心的方法，直接在你的Emacs配置文件（比如~/.emacs或~/.emacs.d/init.el）里加一行配置：

(setq org-link-descriptive t)

这个变量的作用是让Org-mode优先用元素的自然名称（比如标题文本）作为链接描述，而不是直接用链接的原始目标字符串。设置之后，你再用org-store-link和org-insert-link处理带CUSTOM_ID的标题时，链接描述会变回熟悉的标题文本，同时链接目标依然保留CUSTOM_ID（保证跳转的稳定性，不会因为标题修改而失效）。

方案2：自定义链接描述生成函数（更灵活） #

如果你需要更精细的控制，比如针对特定场景调整描述规则，可以自定义org-link-description-function。把下面这段代码加到配置文件里：

(setq org-link-description-function
      (lambda (link)
        (if (string-match "^file:\\(.+\\)::#\\(.+\\)$" link)
            (let* ((file-path (match-string 1 link))
                   (target-id (match-string 2 link))
                   (target-buffer (find-file-noselect file-path)))
              (with-current-buffer target-buffer
                (org-find-property 'CUSTOM_ID target-id)
                (org-get-heading t t t t)))
          (org-link-default-description-function link))))

这个函数会先检查链接是否是带CUSTOM_ID的文件链接，如果是，就自动定位到对应的标题并提取文本作为描述；其他类型的链接则沿用默认的生成逻辑。

生效方式 #

保存配置文件后，要么重启Emacs，要么在配置文件缓冲区执行M-x eval-buffer让配置立即生效，之后再使用链接相关功能就会恢复旧行为了。

内容的提问来源于stack exchange，提问作者JohnL4