SuperAPI AI 工具集

zsh-path

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

用途:管理并排查 zsh 的 PATH 配置,解决已安装工具却提示“command not found”、添加新工具路径、审计现有 PATH 条目、整理 .zshrc 与 .zshrc.local 的配置分工,以及排查与 PATH 相关的 shell 启动问题。

主要能力:提供诊断命令,如用 echo $PATH | tr ':' '\n' 列出所有条目,用 which、command -v、type -a 定位命令,用循环检查失效目录、用 sort | uniq -d 查重复项。给出常见工具的 PATH 配置写法,包括 bun(export BUN_INSTALL="$HOME/.bun" 与 export PATH="$BUN_INSTALL/bin:$PATH")、nvm、Python venv/pyenv、Rust/Cargo、Go、Homebrew(Intel 与 Apple Silicon)以及本地 bin 目录。还说明 PATH 从左到右匹配、首个命中优先,并给出推荐顺序:项目级 bin、用户本地 bin、版本管理器、包管理器、系统路径。

使用方式:把对应 export 语句加入 .zshrc 或 .zshrc.local,团队共享配置放 .zshrc,机器专属配置放 .zshrc.local;修改后用 source ~/.zshrc 或 exec $SHELL 重载,再用 which 与 --version 验证。

适用场景:安装新工具后命令不可用、版本管理器(nvm、pyenv、rbenv)配置、shell 启动钩子报错、PATH 重复或失效条目清理。

限制与注意:资料未提供该技能的安装命令、收费或平台信息。注意 path 数组与 PATH 环境变量需用 typeset -U path PATH 去重;.zprofile 仅登录 shell 执行,.zshrc 面向交互 shell;nvm 是 shell 函数而非二进制,bash -c 脚本会绕过它;懒加载 nvm 可能拖慢 shebang 脚本;source ~/.zshrc 不会撤销旧 PATH 追加,测试时应开新 shell;Apple Silicon 的 /opt/homebrew/bin 对 Rosetta 终端不可见。