使用TRAMP远程连接时Org-mode内联图片无法显示问题求助

问题背景与现象 #

通过TRAMP在远程机器上使用Org-mode连接Jupyter Python内核时，Matplotlib能正常生成PNG图片并保存到远程临时目录，但存在以下异常：

• 代码块输出的图片链接为相对路径，无法内联显示
• 执行C-c C-x C-v提示'No images to display inline'，但C-c o可在其他缓冲区正常打开图片
• 手动修改为完整TRAMP路径后仍无法内联，点击链接（C-f）时路径解析错误，报错示例：

  File is missing: /ssh:bih:/PATH_TO_CORRECT_FOLDER/00_test/file:./.ob-jupyter/

示例代码块及输出：

#+BEGIN_SRC jupyter-python :session /jpy:localhost#9090:TEST
fig = plt.figure()
ax = fig.add_subplot(111)
ax.plot(range(10), range(10))
#+END_SRC

#+RESULTS:
:RESULTS:
| <matplotlib.lines.Line2D | at | 0x7f1c43a289a0> |
[[file:./.ob-jupyter/e1eecf5d59de9bfa1d3468867a64aadf4b1a6261.png]]
:END:

解决方法 #

1. 开启Jupyter的TRAMP识别 #

配置让Jupyter会话自动识别TRAMP环境：

(setq jupyter-server-use-tramp t)

2. 自动替换图片路径为完整TRAMP格式 #

添加Org-mode代码块执行后钩子，自动将结果中的相对图片路径替换为远程机器的完整TRAMP路径：

(defun fix-jupyter-tramp-image-path ()
  (when (string-prefix-p "/jpy:" (org-babel-get-current-session))
    (let* ((session (org-babel-jupyter-get-session (org-babel-get-current-session)))
           (remote-dir (jupyter-session-working-directory session))
           (tramp-parts (split-string remote-dir "@"))
           (tramp-host (car tramp-parts))
           (tramp-path (cadr tramp-parts))
           (full-tramp-dir (concat "/ssh:" tramp-host ":" tramp-path)))
      (goto-char (point-min))
      (while (re-search-forward "\\[\\[file:\\./\\.ob-jupyter/\\([^]]+\\)\\]\\]" nil t)
        (replace-match (format "[[file:%s/.ob-jupyter/%1$s]]" full-tramp-dir) nil nil)))))

(add-hook 'org-babel-after-execute-hook #'fix-jupyter-tramp-image-path)

3. 配置Org-mode图片内联显示 #

确保Org-mode支持图片内联显示的基础配置：

(setq org-startup-with-inline-images t)
(setq org-image-actual-width nil) ; 自动适应窗口宽度显示图片

验证步骤 #

1. 重启Emacs加载上述配置
2. 重新连接远程Jupyter会话
3. 执行Matplotlib绘图代码块，检查结果中的图片链接是否自动变为完整TRAMP路径
4. 执行C-c C-x C-v验证图片是否能正常内联显示

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