虚拟环境下Org Mode带session的Python代码块sys.path异常问题

激活venv虚拟环境后，执行Org Mode中不带:session修饰符的Python代码块时，可正常使用虚拟环境内安装的模块；但带:session的同代码块会调用全局Python环境，无法导入虚拟环境中的模块。

复现步骤 #

$ mkdir test
$ cd test
$ pyenv local 3.10.6
$ python -m venv .venv
$ . .venv/bin/activate
$ pip install numpy scipy
$ emacs test.org

test.org内容：

#+begin_src python :results output
try:
  import numpy
  print('numpy imported')
except ModuleNotFoundError as err:
  print(f'ERROR: {err}')
try:
  import scipy
  print('scipy imported')
except ModuleNotFoundError as err:
  print(f'ERROR: {err}')
import sys
print(sys.executable)
print(sys.path)
#+end_src

#+begin_src python :session :results output
try:
  import numpy
  print('numpy imported')
except ModuleNotFoundError as err:
  print(f'ERROR: {err}')
try:
  import scipy
  print('scipy imported')
except ModuleNotFoundError as err:
  print(f'ERROR: {err}')
import sys
print(sys.executable)
print(sys.path)
#+end_src

执行org-babel-execute-buffer后，不带session的代码块可正常导入模块，sys.executable指向虚拟环境Python；带session的代码块无法导入scipy，sys.executable指向全局Python。

解决方案 #

方法1：全局配置Org Babel使用虚拟环境Python #

在Emacs配置文件中设置org-babel-python-command为虚拟环境内的Python路径：

(setq org-babel-python-command "/path/to/test/.venv/bin/python")

如果需要动态切换环境，可搭配exec-path-from-shell插件，让Emacs启动时继承终端的环境变量，这样org-babel-python-command会自动使用当前激活的虚拟环境Python。

方法2：在代码块中显式指定解释器 #

给带:session的代码块添加:python参数，指定虚拟环境的Python路径：

#+begin_src python :session :python "/path/to/test/.venv/bin/python" :results output
try:
  import numpy
  print('numpy imported')
except ModuleNotFoundError as err:
  print(f'ERROR: {err}')
try:
  import scipy
  print('scipy imported')
except ModuleNotFoundError as err:
  print(f'ERROR: {err}')
import sys
print(sys.executable)
print(sys.path)
#+end_src

此方法适合单个文件临时配置，无需修改全局Emacs设置。

方法3：从激活虚拟环境的终端启动Emacs #

关闭所有Emacs实例，在终端先激活虚拟环境，再启动Emacs：

. .venv/bin/activate
emacs test.org

Emacs会继承终端的环境变量，此时创建的Python session会默认使用虚拟环境的解释器。

方法4：用direnv自动管理环境 #

安装direnv并配置Emacs的direnv插件，当打开test.org所在目录时，direnv会自动激活虚拟环境，确保Org Babel的session代码块使用正确的Python解释器。

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