workbuddy不直接运行python代码，而是调用系统中指定路径的python解释器执行技能；需在设置中手动填入绝对路径（如/opt/homebrew/bin/python3），并配置pythonpath指向自定义模块目录，否则易报importerror。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 本身是桌面应用，不直接运行你的 Python 代码；但它调用本地 Python 执行技能（如数据清洗、脚本自动化）时，依赖的是你系统里真实存在的 python 解释器和它所安装的包。macOS 上装错位置、权限混乱、或路径没配对，就会出现“模块找不到”“ImportError”“subprocess 启动失败”等现象。
确认 Python 解释器路径是否被 WorkBuddy 正确识别
WorkBuddy 不会自动猜你用哪个 Python —— 它只认你手动填进设置里的绝对路径。macOS 自带的 /usr/bin/python3 已被弃用（12.0+ 系统默认不带），而 Homebrew 或官网安装的 Python 默认装在 /opt/homebrew/bin/python3（Apple Silicon）或 /usr/local/bin/python3（Intel）。如果你填了错误路径，WorkBuddy 就会启动失败或报 “Python not found”。
- 终端执行
which python3，看输出是不是你期望的安装路径（比如/opt/homebrew/bin/python3） - 打开 WorkBuddy → 设置 → 运行环境 → Python 解释器路径，粘贴这个完整路径，**不能只写
python3** - 点“测试连接”，必须返回版本号（如
3.11.9）且无报错才算成功 - 如果返回空或报错，说明路径不对，或该 Python 没装好（可尝试重新安装官方 .pkg 包）
用 venv 创建隔离环境并让 WorkBuddy 调用它
WorkBuddy 的技能代码是在沙箱中运行的，但当你用 subprocess 调用本地脚本时，实际执行的是你指定解释器路径下的环境。所以最稳妥的做法，不是往系统 Python 里 pip install，而是建一个专用 venv，再把它的 python 路径填进 WorkBuddy 设置里。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 终端进入你放 Python 脚本的目录（比如
~/workbuddy-scripts），执行：python3 -m venv wb-env - 激活后安装依赖：
source wb-env/bin/activate && pip install pandas openpyxl requests - 记下这个环境的 Python 路径：
which python（输出类似/Users/xxx/workbuddy-scripts/wb-env/bin/python） - 把这个路径填进 WorkBuddy 的“Python 解释器路径”，而非系统全局的
python3 - 这样即使你系统里有多个 Python 版本或冲突包，WorkBuddy 也只会用这个干净环境
为什么 pip install 到系统 Python 仍可能失败
macOS 对 /usr/local 和 /opt/homebrew 下文件的写入权限越来越严格，尤其启用 SIP（System Integrity Protection）后，直接 pip install -g 很容易 Permission Denied，或者装完却不在 PATH 里生效。
- Homebrew 安装的 Python 默认要求你用
brew upgrade python升级，而不是pip install --upgrade pip，后者可能破坏 brew 管理状态 - 用
sudo pip install是危险操作，可能导致pip自身损坏，且 WorkBuddy 无法继承 root 权限 - macOS 13+ 开始，某些框架（如 PyObjC）需额外安装 Xcode Command Line Tools：
xcode-select --install，否则 import 失败 - 如果你用的是 Apple Silicon Mac，确保所有包都支持 arm64 架构；部分旧版二进制包（如某些
tensorflow预编译轮子）仅支持 x86_64，会导致ImportError: dlopen() failed
PYTHONPATH 配置不当导致模块导入失败
WorkBuddy 执行脚本时，默认工作目录是插件沙箱路径（~/Library/Application Support/WorkBuddy/Claw/...），不是你放 .py 文件的地方。不设 PYTHONPATH，import myutils 就会报错。
- 在 WorkBuddy 设置 → 环境变量 → 添加变量，键名填
PYTHONPATH，键值填你自定义模块所在目录的**绝对路径**（如/Users/xxx/my-python-libs） - 多个路径用冒号
:分隔，不要加空格（/path/a:/path/b） - 路径末尾不要加斜杠，否则 Python 可能忽略该路径
- 改完后重启 WorkBuddy，否则新变量不生效
真正卡住人的从来不是“怎么装”，而是“装到哪”和“谁在用”。macOS 上每个 Python 安装方式（系统自带、Homebrew、pyenv、官网 .pkg）管理路径和权限的逻辑完全不同，WorkBuddy 只负责调用，不会帮你判断该用哪个 —— 你填什么路径，它就信什么。所以路径写错、venv 没激活就 pip install、PYTHONPATH 漏掉根目录，这三件事占了 80% 的导入失败案例。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
