6ddba3e722
feat: 完成 Zsh 插件配置脚本的优化和测试 - 修复 autojump 配置冲突 - 清理重复的插件安装 - 优化脚本结构和注释 feat: 优化shell脚本 - 1. 增强错误处理和恢复机制 2. 添加网络连接优化和镜像源支持 3. 改进进度显示和用户交互 4. 优化配置文件管理和备份 5. 改进插件管理机制 6. 增强依赖检查和安装 7. 添加完整的日志记录功能 8. 修复字体安装相关问题 docs: 完善shell、system和utils部分的README文档 - 1. 添加详细的脚本说明和使用方法 2. 补充依赖要求和注意事项 3. 添加常见问题解答 4. 更新版本日志 feat(editor): 优化 neovim 和 nvchad 安装脚本，添加性能优化配置和详细文档 feat: 优化Python开发环境安装脚本，分离基础包和机器学习包，修复virtualenvwrapper配置 feat: 优化开发工具安装脚本，统一使用common.sh中的函数，改进错误处理 fix: 修复DNMP安装脚本，跳过自动配置PHP开发环境 fix: 提交删除的 init.sh 和 mysql.sh 文件
2.4 KiB
2.4 KiB
工具脚本集合
本目录包含各种通用工具脚本，用于提供基础功能和辅助其他脚本运行。
目录结构
utils/
├── README.md # 本文档
├── common.sh # 通用shell函数库
└── check_user.sh # 用户权限检查工具
脚本说明
common.sh
通用shell函数库，提供了各种常用的shell函数。
功能
-
日志管理
setup_logging: 设置日志系统log_info: 记录信息日志log_warn: 记录警告日志log_error: 记录错误日志log_success: 记录成功日志
-
进度显示
show_progress: 显示进度条update_progress: 更新进度
-
网络管理
check_network: 检查网络连接get_mirror_url: 获取镜像源URL
-
配置管理
manage_config: 管理配置文件manage_plugin: 管理插件
-
依赖管理
check_dependencies: 检查依赖install_base_dependencies: 安装基础依赖
-
用户交互
confirm: 用户确认提示get_user_info: 获取用户信息
-
文件管理
download_file: 下载文件manage_path: 管理PATH环境变量manage_alias: 管理命令别名
使用方法
# 在脚本中引入
source ./utils/common.sh
# 使用函数
log_info "开始安装..."
show_progress "安装进度" 0
check_user.sh
用户权限检查工具，用于检查脚本运行环境和权限。
功能
- 检查root权限
- 检查用户信息
- 检查系统环境
- 检查必要命令
使用方法
# 在脚本中引入
source ./utils/check_user.sh
# 检查权限
check_root
依赖要求
- Debian/Ubuntu系统
- bash shell
- 基本系统工具（curl, wget等）
使用建议
- 在脚本开头引入需要的工具脚本
- 使用提供的函数而不是直接实现功能
- 遵循错误处理和日志记录规范
- 使用进度显示提供更好的用户体验
注意事项
- 确保脚本有执行权限
- 注意函数的依赖关系
- 正确处理错误情况
- 保持日志记录的完整性
常见问题
- 如果函数未定义，检查是否正确引入了脚本
- 如果权限检查失败，确保使用sudo运行
- 如果网络检查失败，检查网络连接
- 如果日志记录失败，检查日志目录权限
更新日志
v1.0.0 (2024-03-xx)
- 初始版本发布
- 完成通用函数库
- 实现用户检查工具
- 添加完整的错误处理