📦 CodeSync - 代码同步工具使用手册

⚠️ 重要警告 - 请务必仔细阅读！

CodeSync是一个强力同步工具，使用--delete参数，会强制让目标目录与源目录保持完全一致！

这意味着如果源目录为空或文件较少，目标目录的额外文件将被永久删除！

📋 工具概述

CodeSync是基于rsync的代码同步工具，用于在开发机和备份服务器之间同步代码。它支持双向同步，但操作具有破坏性，请谨慎使用。

🔧 基本语法

codesync <操作> <项目>

操作:
  put    - 上传本地代码到远程服务器
  get    - 从远程服务器下载代码到本地

项目:
  perl   - Perl模块代码
  python - Python代码  
  java   - Java代码

📁 目录映射关系

项目 本地目录 远程目录
perl /etc/apache2/modperl /code_backup/modperl
python $HOME/code_backup/python /code_backup/python
java $HOME/code_backup/java /code_backup/java

💣 危险场景警告

场景1：远程目录为空时执行GET操作

⚠️ 极其危险：如果远程java目录为空，执行codesync get java会清空本地java目录！

正确做法：先执行codesync put java将本地代码上传到远程

场景2：本地目录为空时执行PUT操作

⚠️ 极其危险：如果本地java目录为空，执行codesync put java会清空远程java目录！

正确做法：先执行codesync get java将远程代码下载到本地

✅ 标准工作流程

开发机 → 备份服务器 → 生产机

步骤1：开发人员在开发机上修改java代码
步骤2：在开发机执行上传命令
$ codesync put java
步骤3：在生产机执行下载命令
$ codesync get java

📝 使用示例

上传代码到备份服务器

# 上传Perl模块
codesync put perl

# 上传Python代码
codesync put python

# 上传Java代码
codesync put java

从备份服务器下载代码

# 下载Perl模块
codesync get perl

# 下载Python代码
codesync get python

# 下载Java代码
codesync get java

查看帮助信息

# 显示使用帮助
codesync

🔍 使用前检查清单

执行PUT操作前：

执行GET操作前：

🚨 错误处理

如果同步过程中出现错误，脚本会显示具体的错误信息：

🎯 最佳实践

推荐做法：

⚙️ 技术细节

CodeSync使用以下rsync参数：

📜 免责声明

重要提醒：

1. CodeSync是一个强力同步工具，具有数据覆盖和删除的能力

2. 用户必须完全理解命令的运行机制后才能使用

3. 建议在使用前对重要数据进行备份

4. 作者和维护团队不对因使用此工具导致的数据丢失承担任何责任

5. 用户使用此工具即表示理解并接受相关风险

请谨慎操作，确保数据安全！

© 2025 CodeSync 使用手册 - 请在充分理解风险后使用