VS Code远程Jupyter无法加载本地编译库libismrmrd.so.1.7

核心原因是：从终端外启动VS Code（或Windows远程连接Linux工作机）时，VS Code的Jupyter内核不会加载shell配置文件（如~/.bashrc、~/.zshrc）中设置的LD_LIBRARY_PATH环境变量。而本地编译的共享库（如libismrmrd.so.1.7）的路径通常是在这些配置文件中添加的，终端启动程序时会自动加载该环境变量，因此终端内的IPython、VS Code、浏览器版Jupyter都能正常运行。

方法1：在VS Code中直接配置环境变量 #

• 按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac）打开命令面板
• 输入Preferences: Open Settings (JSON)打开设置文件
• 添加以下配置，将<你的共享库路径>替换为libismrmrd.so.1.7所在的目录（例如/usr/local/lib或编译时指定的安装路径）：

  "terminal.integrated.env.linux": {
      "LD_LIBRARY_PATH": "<你的共享库路径>:${env:LD_LIBRARY_PATH}"
  },
  "jupyter.env": {
      "LD_LIBRARY_PATH": "<你的共享库路径>:${env:LD_LIBRARY_PATH}"
  }
  

• 保存设置后，重启VS Code的Jupyter内核，重新运行代码

方法2：修改Jupyter内核配置文件 #

• 在终端运行以下命令，找到当前使用的Python3.10.6对应内核的路径：

  jupyter kernelspec list
  

• 进入该内核目录，编辑kernel.json文件，在env字段中添加共享库路径：

  {
    "argv": [
      "/usr/bin/python3.10",
      "-m",
      "ipykernel_launcher",
      "-f",
      "{connection_file}"
    ],
    "display_name": "Python 3.10.6",
    "language": "python",
    "env": {
      "LD_LIBRARY_PATH": "<你的共享库路径>:${LD_LIBRARY_PATH}"
    }
  }
  

• 保存文件后，重启Jupyter内核

方法3：全局配置共享库路径（永久生效） #

• 将共享库路径添加到系统全局配置中，所有程序均可识别：

  sudo echo "<你的共享库路径>" > /etc/ld.so.conf.d/ismrmrd.conf
  sudo ldconfig
  

• 此方法无需修改VS Code或Jupyter配置，系统层面永久生效

修改完成后，重新运行导入代码，确认ImportError: libismrmrd.so.1.7: cannot open shared object file: No such file or directory报错消失。

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