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 文件
115 lines
2.4 KiB
Markdown
115 lines
2.4 KiB
Markdown
# 工具脚本集合
|
||
|
||
本目录包含各种通用工具脚本，用于提供基础功能和辅助其他脚本运行。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
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`: 管理命令别名
|
||
|
||
#### 使用方法
|
||
```bash
|
||
# 在脚本中引入
|
||
source ./utils/common.sh
|
||
|
||
# 使用函数
|
||
log_info "开始安装..."
|
||
show_progress "安装进度" 0
|
||
```
|
||
|
||
### check_user.sh
|
||
|
||
用户权限检查工具，用于检查脚本运行环境和权限。
|
||
|
||
#### 功能
|
||
- 检查root权限
|
||
- 检查用户信息
|
||
- 检查系统环境
|
||
- 检查必要命令
|
||
|
||
#### 使用方法
|
||
```bash
|
||
# 在脚本中引入
|
||
source ./utils/check_user.sh
|
||
|
||
# 检查权限
|
||
check_root
|
||
```
|
||
|
||
## 依赖要求
|
||
|
||
- Debian/Ubuntu系统
|
||
- bash shell
|
||
- 基本系统工具（curl, wget等）
|
||
|
||
## 使用建议
|
||
|
||
1. 在脚本开头引入需要的工具脚本
|
||
2. 使用提供的函数而不是直接实现功能
|
||
3. 遵循错误处理和日志记录规范
|
||
4. 使用进度显示提供更好的用户体验
|
||
|
||
## 注意事项
|
||
|
||
- 确保脚本有执行权限
|
||
- 注意函数的依赖关系
|
||
- 正确处理错误情况
|
||
- 保持日志记录的完整性
|
||
|
||
## 常见问题
|
||
|
||
1. 如果函数未定义，检查是否正确引入了脚本
|
||
2. 如果权限检查失败，确保使用sudo运行
|
||
3. 如果网络检查失败，检查网络连接
|
||
4. 如果日志记录失败，检查日志目录权限
|
||
|
||
## 更新日志
|
||
|
||
### v1.0.0 (2024-03-xx)
|
||
- 初始版本发布
|
||
- 完成通用函数库
|
||
- 实现用户检查工具
|
||
- 添加完整的错误处理 |