🧠 定位与价值 >>>

• oh-my-bash：Bash 配置框架，不是 Bash 本体
• 主题 / 插件 / 别名 / 补全 / 自定义：收拢到一套可迁移的入口里
• ~/.bashrc ~/.bash_profile：安装后会接管 Bash 的加载链，Windows 的 Git Bash 还要关注这两个入口
• dotfiles 管理：适合想要更清晰的提示符、更少的重复输入、以及更统一配置的人
• 激活成功：最直观的变化就是主题、别名和补全开始生效

# 先找入口，再谈功能
echo "$OSH"
echo "$OSH_THEME"

🧭 快速定位 >>>

• OSH ~/.oh-my-bash：Oh My Bash 安装目录，默认是
• OSH_THEME font：当前主题名，默认模板是
• plugins：需要加载的插件数组
• aliases：需要加载的别名包数组
• completions：需要加载的补全数组
• source "$OSH"/oh-my-bash.sh：真正启动 Oh My Bash 的入口
• upgrade_oh_my_bash：手动更新
• uninstall_oh_my_bash：卸载并回退配置

echo "$OSH"
echo "$OSH_THEME"
type upgrade_oh_my_bash
type uninstall_oh_my_bash

📦 安装 >>>

• bash -c "$(curl -fsSL ...)"：通过 curl 安装（推荐）
• bash -c "$(wget -qO- ...)"：无 curl 时用 wget 替代
• ~/.bashrc.omb-backup-*：安装时自动备份的原始配置
• OSH_THEME ~/.bashrc：安装后在 里改这一行就可以换主题
• git clone source：先 仓库，再手动追加 入口

# curl 安装
bash -c "$(curl -fsSL https://raw.githubusercontent.com/ohmybash/oh-my-bash/master/tools/install.sh)"

# wget 安装
bash -c "$(wget -qO- https://raw.githubusercontent.com/ohmybash/oh-my-bash/master/tools/install.sh)"

# 离线 / 指定目录安装
OSH=~/.oh-my-bash git clone https://github.com/ohmybash/oh-my-bash.git "$OSH"
# 然后手动在 ~/.bashrc 追加：
# export OSH="$HOME/.oh-my-bash"
# source "$OSH/oh-my-bash.sh"

🪟 Windows / Git Bash 起手 >>>

• ~/.bashrc ~/.bash_profile
• ~/.bash_profile source ~/.bashrc
• /c/Users/<name>/... C:\...
• notepad.exe ~/.bashrc code ~/.bashrc
• 如果主题符号乱码，先换终端字体，再判断是不是主题不兼容
• 推荐终端 : Windows Terminal + Git Bash profile，比默认 mintty 更稳

# ~/.bash_profile
if [[ -f ~/.bashrc ]]; then
  source ~/.bashrc
fi

# Windows 路径和 Unix 路径互转
cygpath -u 'C:\Users\me\Downloads'
cygpath -w '/c/Users/me/.oh-my-bash'

✅ 安装后验证 / 激活检查 >>>

• test -d ~/.oh-my-bash：目录存在，说明文件已落地
• echo "$OSH"：应该输出安装目录
• echo "$OSH_THEME"：当前主题变量已读入
• type upgrade_oh_my_bash：更新命令可用，说明框架脚本已加载
• type uninstall_oh_my_bash：卸载命令可用，说明脚本已注入当前 shell
• declare -p plugins aliases completions 2>/dev/null：检查常用数组是否已读入
• grep -nE 'source ~/.bashrc|\\. ~/.bashrc' ~/.bash_profile ~/.bashrc 2>/dev/null：Git Bash 的启动链检查
• exec bash：重启当前 shell 再看一次最终效果

# 基本验证
test -d ~/.oh-my-bash && echo "installed"
echo "$OSH"
echo "$OSH_THEME"
type upgrade_oh_my_bash
type uninstall_oh_my_bash

# Git Bash 启动链
grep -nE 'source ~/.bashrc|\. ~/.bashrc' ~/.bash_profile ~/.bashrc 2>/dev/null

# 重新加载后再确认
source ~/.bashrc

🚀 最小工作流 >>>

source ~/.bashrc
alias
declare -p OSH_THEME plugins aliases completions 2>/dev/null

🎨 主题切换 >>>

• OSH_THEME="font"：默认主题，最稳
• OSH_THEME="random"：每次随机一个主题
• OMB_THEME_RANDOM_CANDIDATES=(...)：只从指定列表里随机
• OMB_THEME_RANDOM_IGNORED=(...)：排除不想要的主题
• OMB_THEME_RANDOM_SELECTED：当前随机到的主题名
• agnoster：常见漂亮主题，但通常需要 Powerline / Nerd Font
• ls "$OSH/themes"
• OSH_THEME=xxx source ~/.bashrc：直接 ，不用重开终端

# 主题切换：稳妥起步
OSH_THEME="font"

# 主题切换：随机，但限制候选
OSH_THEME="random"
OMB_THEME_RANDOM_CANDIDATES=("font" "powerline-light" "minimal")
OMB_THEME_RANDOM_IGNORED=("powerbash10k" "wanelo")

# 快速预览所有主题（循环切换，每次回车换下一个）
for theme in "$OSH"/themes/*/; do
  t=$(basename "$t")
  echo ">>> $t"
  OSH_THEME="$t" source ~/.bashrc
  read -r
done

🧩 插件 / 别名 / 补全 >>>

• completions=(git composer ssh)：按需加载补全
• aliases=(general)：加载别名包
• plugins=(git bashmarks)：加载插件包
• custom/completions/：自定义补全目录
• custom/aliases/：自定义别名目录
• custom/plugins/：自定义插件目录
• custom/themes/：自定义主题目录
• ls "$OSH/plugins"
• ls "$OSH/aliases"
• ls "$OSH/completions"

# 典型配置
completions=(
  git
  composer
  ssh
)

aliases=(
  general
)

plugins=(
  git
  bashmarks
)

# 条件加载：只在 SSH 会话里启用某个插件
[ "$SSH_TTY" ] && plugins+=(tmux-autoattach)

# 查看某个别名包里定义了哪些别名
cat "$OSH/aliases/general.aliases.sh"

# 查看某个插件提供了什么函数
grep -E '^function |^[a-z_]+\(\)' "$OSH/plugins/git/git.plugin.sh"

常用内置别名（general）

• .. ... ....：向上跳 1 / 2 / 3 层目录
• ll ls -lh
• la ls -lAh
• lx：按扩展名排序列目录
• lk：按文件大小排序
• lt：按修改时间排序
• md mkdir -p
• rd rmdir
• please sudo：（复用上一条命令时加 sudo）
• h history
• j jobs -l

# 这些是 general 别名包给你的，不用自己写
..        # cd ..
...       # cd ../..
ll        # ls -lh
la        # ls -lAh
md foo    # mkdir -p foo
please    # sudo !!
h | grep ssh

常用内置别名（git）

• g git
• ga git add
• gaa git add --all
• gc git commit
• gcm git commit -m
• gco git checkout
• gcb git checkout -b
• gd git diff
• gds git diff --staged
• gl git pull
• gp git push
• gst git status
• glg git log --oneline --graph --decorate

# 日常 git 流程极简版
gaa
gcm "fix: typo"
gp

💬 提示符变量（Prompt） >>>

• OMB_PROMPT_SHOW_PYTHON_VENV=true：显示 Python 虚拟环境名
• OMB_PROMPT_SHOW_SPACK_ENV=true：显示 Spack 环境名
• OMB_PROMPT_SHOW_RUBY_GEMSET=true：显示 RVM gemset（部分主题支持）
• OMB_PROMPT_SHOW_NVM_VERSION=true：显示 Node 版本（部分主题支持）
• OMB_PROMPT_SHOW_AWS_VAULT=true：显示 aws-vault profile（部分主题支持）
• OMB_USE_SUDO=true：允许 Oh My Bash 内部命令在需要时使用 sudo
• OMB_TERM_USE_TPUT=true：用 tput 代替转义序列初始化颜色，可降低开销

# 在 ~/.bashrc 里，放在 source oh-my-bash.sh 之前生效
export OMB_PROMPT_SHOW_PYTHON_VENV=true
export OMB_PROMPT_SHOW_SPACK_ENV=false
export OMB_TERM_USE_TPUT=true

🛠️ 自定义与覆盖 >>>

• OSH_CUSTOM：自定义目录根路径
• custom/：里的同名文件会覆盖内置模块
• theme/plugin/alias/completion：都可以按同样思路覆盖
• 先复制再改 : 适合想保留上游更新能力的场景
• custom/ .sh：会被自动 source，适合放全局函数和环境变量

# 自定义目录放到 dotfiles 里
export OSH_CUSTOM="$HOME/.dotfiles/oh-my-bash-custom"

# 覆盖主题
mkdir -p "$OSH_CUSTOM/themes"
cp -r "$OSH/themes/agnoster" "$OSH_CUSTOM/themes/"

# 新建全局自定义脚本（会被自动 source）
cat > "$OSH_CUSTOM/my-exports.sh" << 'EOF'
export EDITOR=vim
export HISTSIZE=50000
export HISTFILESIZE=100000
EOF

$OSH_CUSTOM/
├─ themes/
├─ plugins/
├─ aliases/
├─ completions/
└─ my-exports.sh   ← 任意 .sh 文件都会被自动加载

🔄 更新 / 卸载 / 迁移 >>>

• upgrade_oh_my_bash：手动更新到最新提交
• DISABLE_UPDATE_PROMPT=true：关闭升级提示
• DISABLE_AUTO_UPDATE=true：关闭自动更新检查
• UPDATE_OSH_DAYS=13：调整检查间隔（天数）
• uninstall_oh_my_bash：回滚并删除安装
• ~/.bashrc $OSH_CUSTOM：只需复制 和 目录，再重新安装框架本体

# 手动更新
upgrade_oh_my_bash

# 关闭自动检查
DISABLE_AUTO_UPDATE=true

# 迁移：打包自定义配置
tar czf omb-custom.tar.gz ~/.bashrc "$OSH_CUSTOM"

⚡ 性能调优 >>>

• time bash -i -c exit：测量 Bash 启动耗时，基线应在 200ms 以内
• DISABLE_AUTO_UPDATE=true：更新检查会在后台加一次网络请求
• completions：是最常见的启动杀手，只留必要的
• OMB_TERM_USE_TPUT=true：降低终端颜色初始化成本
• $(git status)：每次刷新提示符都会 fork 一个进程
• 关闭 dirty 检查 : 大仓库里 git dirty 状态检测极慢，主题通常有开关变量

# 测基线
time bash -i -c exit

# 二分法定位慢在哪一段
# 注释掉一半 plugins，再测；缩小范围直到找到元凶
time bash -i -c exit

# 关闭 git dirty 检测（以 powerline 主题为例）
OMB_THEME_POWERLINE_DISABLE_GIT_STATUS=true

⚠️ 常见坑 >>>

• ~/.bash_profile ~/.bashrc：Git Bash 里最常见
• 主题乱码 : 先换字体（推荐 Nerd Font / Cascadia Code PL），再换主题
• time bash -i -c exit：少加载插件和补全，用 定位
• PATH .bashrc：检查 是否被你自己的 改坏
• 仓库状态太慢 : 关闭过重的 dirty 检查
• OSH_CUSTOM .sh .sh：文件名里不能有空格，扩展名必须是
• $OSH/themes/：检查是否直接改了 下的文件，改动被覆盖了
• echo "$BASH_VERSION"：确认当前用的是哪个
• complete completions source oh-my-bash.sh：检查 数组是否写在 之前

# 排查顺序
echo "$0"
echo "$BASH_VERSION"
echo "$OSH"
echo "$OSH_THEME"
echo "$OSH_CUSTOM"
source ~/.bashrc

📌 Quick Ref >>>