BorgBackup 2.0文档语法修正指南

BorgBackup作为一款优秀的去重备份工具，在2.0版本中对命令行语法进行了重要变更。最显著的变化之一是废弃了旧版本中使用的repo::archive语法格式，转而采用更清晰的参数传递方式。

语法变更背景

在BorgBackup 1.x版本中，用户习惯使用repo::archive这种连接符语法来指定仓库和归档。这种语法虽然简洁，但在某些情况下可能造成解析歧义，特别是在处理包含特殊字符的路径时。2.0版本对此进行了重构，采用更标准的命令行参数传递方式。

新旧语法对比

旧语法示例：

borg create ssh://server/path/to/repo::archive /backup/path

新语法标准：

borg create --repo ssh://server/path/to/repo archive /backup/path

关键变化点：

1. 移除了::分隔符
2. 使用明确的--repo参数指定仓库路径
3. 归档名称作为独立参数传递

文档修正要点

在更新文档时需要注意以下内容：

1. 所有命令示例中的repo::archive语法都需要更新
2. 环境变量BORG_REPO的使用方式保持不变
3. 位置参数顺序仍然重要，但不再需要特殊分隔符
4. 建议优先使用长选项--repo而非短选项-r以提高可读性

实际应用建议

对于日常使用，推荐以下最佳实践：

1. 对于常用仓库，设置BORG_REPO环境变量可以简化命令
2. 在脚本中使用完整--repo参数提高可读性和可维护性
3. 复杂路径建议用引号包裹，如：--repo "ssh://user@host/path with spaces/repo"

向后兼容性

虽然新版本不再支持::语法，但1.x版本的仓库仍然可以兼容使用。迁移时只需注意命令语法的调整，数据格式本身保持兼容。

通过这次语法规范化，BorgBackup在保持强大功能的同时，提供了更清晰、更标准的命令行接口，有利于长期维护和用户理解。对于开发者来说，在贡献文档时应当特别注意这些语法变更，确保示例代码的准确性。