如何修复macOS下应用调用脚本触发Taskwarrior Python钩子的报错

Karabiner Elements作为GUI应用，调用shell时不会加载终端交互式环境下的配置文件（如.zshrc、.bash_profile等），默认环境变量中缺失Homebrew Python的路径、pip用户库的搜索路径，导致Python钩子运行时无法找到你提前安装的tasklib依赖。

• 方案1（快速生效，无需修改其他文件）：在调用task命令的Bash语句中补充PYTHONPATH环境变量
  你报错信息里已经显示tasklib的安装路径为/Users/me/Library/Python/3.8/lib/python/site-packages，直接将Karabiner对应配置中的命令修改为：

/bin/bash -c 'TASKRC=/Users/me/.taskrc PYTHONPATH=/Users/me/Library/Python/3.8/lib/python/site-packages /usr/local/bin/task add "the task"'

如果后续更换Python版本，重新执行python3 -c "import site; print(site.getusersitepackages())"获取新的路径替换即可。

• 方案2（一劳永逸，修改钩子脚本的Python解释器路径）
  钩子脚本默认的#!/usr/bin/env python3会根据环境变量搜索Python解释器，在Karabiner的极简环境下可能匹配到系统自带的Python而非你用Homebrew安装的版本。你可以在终端执行which python3获取Homebrew Python的绝对路径（一般为/usr/local/bin/python3或者Apple Silicon机型的/opt/homebrew/bin/python3），将钩子脚本第一行替换为绝对路径即可：

#!/usr/local/bin/python3

该方案修改后，无论通过什么环境调用钩子，都会固定使用你安装了依赖的Python版本。

• 方案3：在Perl调用层补充环境变量
  如果你的Karabiner调用的Perl脚本需要执行多个关联命令，可以在Perl脚本最开头提前配置好环境变量，后续所有命令都会继承配置：

$ENV{PATH} = "/usr/local/bin:/opt/homebrew/bin:$ENV{PATH}";
$ENV{PYTHONPATH} = "/Users/me/Library/Python/3.8/lib/python/site-packages";

你可以在终端执行以下命令模拟Karabiner的干净执行环境，验证修复是否生效：

env -i /bin/bash -c '修改后的task命令'

如果执行无报错，说明配置正确。

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