Emacs首次点击org文件zotero链接失效 执行eval-buffer后正常原因查询

你的自定义zotero链接注册逻辑执行时机错误，导致Emacs启动阶段没有成功完成链接类型注册：

• Emacs启动时是按配置文件的书写顺序逐行执行代码的，如果你把注册zotero链接的两行代码写在了Org模式加载逻辑的前面，执行到(org-add-link-type "zotero" 'zotero-org)这行时，org-add-link-type函数还没随Org包加载到内存，这行代码会直接触发「无此函数」的报错，链接类型注册完全失败。此时Org模式不识别zotero://开头的链接，点击自然没有任何响应。
• 当你手动打开.emacs文件执行M-x eval-buffer重载配置时，你已经打开过org文件，Org模式已经完成加载，org-add-link-type函数已经存在，这时候注册代码才能正常执行，把zotero链接的处理逻辑注册到Org的链接体系里，后续点击链接就能正常跳转到Zotero客户端。

另外你当前用的org-add-link-type是Org模式的旧版API，新版Org已经推荐用org-link-set-parameters做链接注册，兼容性更好。

用with-eval-after-load把链接注册逻辑包裹起来，强制要求等Org模式加载完成后再执行注册代码，从根源避免时机错误，参考配置如下：

(defun zotero-org (path)
  (browse-url (format "zotero:%s" path)))

(with-eval-after-load 'org
  ;; 新版Org用下面这行
  (org-link-set-parameters "zotero" :follow #'zotero-org)
  ;; 如果是老版本Org没有上面的函数，就注释掉上面那行，用下面这行
  ;; (org-add-link-type "zotero" 'zotero-org)
)

替换原有配置后重启Emacs，无需手动eval-buffer就能直接点击zotero链接正常跳转。

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