mgmt/docs/setup/zsh-configuration.md

ZSH 配置总结

已安装和配置的组件

1. 基础组件

• ✅ oh-my-zsh: 已安装并配置
• ✅ zsh: 版本 5.9
• ✅ Powerline 字体: 已安装支持
• ✅ tmux: 已安装

2. 核心插件

• ✅ git: Git 集成和别名
• ✅ docker: Docker 命令补全和别名
• ✅ docker-compose: Docker Compose 支持
• ✅ ansible: Ansible 命令补全
• ✅ terraform: Terraform/OpenTofu 支持
• ✅ kubectl: Kubernetes 命令补全
• ✅ helm: Helm 包管理器支持
• ✅ aws: AWS CLI 支持
• ✅ gcloud: Google Cloud CLI 支持

3. 增强插件

• ✅ zsh-autosuggestions: 命令自动建议
• ✅ zsh-syntax-highlighting: 语法高亮
• ✅ zsh-completions: 增强补全功能
• ✅ colored-man-pages: 彩色手册页
• ✅ command-not-found: 命令未找到提示
• ✅ extract: 解压文件支持
• ✅ history-substring-search: 历史搜索
• ✅ sudo: sudo 支持
• ✅ systemd: systemd 服务管理
• ✅ tmux: tmux 集成
• ✅ vscode: VS Code 集成
• ✅ web-search: 网络搜索
• ✅ z: 智能目录跳转

4. 主题

• ✅ agnoster: 功能丰富的主题，支持 Git 状态显示

自定义别名

项目管理别名

mgmt              # 进入管理项目目录
mgmt-status       # 显示项目状态
mgmt-deploy       # 快速部署
mgmt-cleanup      # 清理环境
mgmt-swarm        # Swarm 管理
mgmt-tofu         # OpenTofu 管理

Ansible 别名

ansible-check     # 语法检查
ansible-deploy    # 部署
ansible-ping      # 连通性测试
ansible-vault     # 密码管理
ansible-galaxy    # 角色管理

OpenTofu/Terraform 别名

tofu-init         # 初始化
tofu-plan         # 计划
tofu-apply        # 应用
tofu-destroy      # 销毁
tofu-output       # 输出
tofu-validate     # 验证
tofu-fmt          # 格式化

Docker 别名

d                 # docker
dc                # docker-compose
dps               # docker ps
dpsa              # docker ps -a
di                # docker images
dex               # docker exec -it
dlog              # docker logs -f
dclean            # docker system prune -f

Docker Swarm 别名

dswarm            # docker swarm
dstack            # docker stack
dservice          # docker service
dnode             # docker node
dnetwork          # docker network
dsecret           # docker secret
dconfig           # docker config

Kubernetes 别名

k                 # kubectl
kgp               # kubectl get pods
kgs               # kubectl get services
kgd               # kubectl get deployments
kgn               # kubectl get nodes
kaf               # kubectl apply -f
kdf               # kubectl delete -f
kl                # kubectl logs -f

Git 别名

gs                # git status
ga                # git add
gc                # git commit
gp                # git push
gl                # git pull
gd                # git diff
gb                # git branch
gco               # git checkout

系统别名

ll                # ls -alF
la                # ls -A
l                 # ls -CF
..                # cd ..
...               # cd ../..
....              # cd ../../..
grep              # grep --color=auto
ports             # netstat -tuln
myip              # 获取公网IP
speedtest         # 网速测试
psg               # ps aux | grep
top               # htop

配置文件位置

• 主配置: ~/.zshrc
• 自定义别名: ~/.oh-my-zsh/custom/aliases.zsh
• 代理配置: /root/mgmt/configuration/proxy.env

使用方法

启动 ZSH

zsh

重新加载配置

source ~/.zshrc

查看所有别名

alias

查看特定别名

alias | grep docker
alias | grep mgmt

功能特性

1. 自动建议

• 输入命令时会显示历史命令建议
• 使用 → 键接受建议

2. 语法高亮

• 命令输入时实时语法高亮
• 错误命令显示为红色

3. 智能补全

• 支持所有已安装工具的补全
• 支持文件路径补全
• 支持命令参数补全

4. 历史搜索

• 使用 ↑ ↓ 键搜索历史命令
• 支持部分匹配搜索

5. 目录跳转

• 使用 z 命令智能跳转到常用目录
• 基于访问频率和最近访问时间

6. 代理支持

• 自动加载代理配置
• 支持 HTTP/HTTPS 代理

故障排除

如果别名不工作

# 检查别名是否加载
alias | grep <alias-name>

# 重新加载配置
source ~/.zshrc

如果插件不工作

# 检查插件是否安装
ls ~/.oh-my-zsh/plugins/ | grep <plugin-name>

# 检查自定义插件
ls ~/.oh-my-zsh/custom/plugins/

如果主题显示异常

# 检查字体是否安装
fc-list | grep Powerline

# 尝试其他主题
# 编辑 ~/.zshrc 中的 ZSH_THEME

扩展建议

可以添加的额外插件

• fzf: 模糊查找
• bat: 更好的 cat 命令
• exa: 更好的 ls 命令
• ripgrep: 更快的 grep
• fd: 更快的 find

可以添加的额外别名

• 根据个人使用习惯添加更多别名
• 为常用命令组合创建别名
• 为项目特定命令创建别名

性能优化

• 已配置的插件数量适中，不会显著影响启动速度
• 使用 zsh-completions 提供更好的补全性能
• 历史记录配置优化，避免内存占用过大

配置完成！现在您拥有了一个功能强大、高度定制的 ZSH 环境，专门为管理系统的需求进行了优化。