设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
-
2.52.0
2025-11-17
- 2.50.1 → 2.51.2 无更改
-
2.50.0
2025-06-16
- 2.47.1 → 2.49.1 无更改
-
2.47.0
2024-10-06
- 2.42.2 → 2.46.4 无更改
-
2.42.1
2023-11-02
- 2.38.1 → 2.42.0 无更改
-
2.38.0
2022-10-02
概要
scalar clone [--single-branch] [--branch <main-branch>] [--full-clone] [--[no-]src] [--[no-]tags] [--[no-]maintenance] <url> [<enlistment>] scalar list scalar register [--[no-]maintenance] [<enlistment>] scalar unregister [<enlistment>] scalar run ( all | config | commit-graph | fetch | loose-objects | pack-files ) [<enlistment>] scalar reconfigure [--maintenance=(enable|disable|keep)] [ --all | <enlistment> ] scalar diagnose [<enlistment>] scalar delete <enlistment>
描述
Scalar 是一款用于优化 Git 以在大型仓库中使用的仓库管理工具。Scalar 通过配置高级 Git 设置、在后台维护仓库以及帮助减少网络传输数据来提高性能。
Scalar 的一个重要概念是 enlistment（注册）：这是项目的顶层目录。它通常包含 src/ 子目录，这是一个 Git 工作树。这鼓励了跟踪文件（位于 src/ 内）和未跟踪文件（例如构建产物，位于 src/ 外）之间的分离。当使用 Scalar 注册现有 Git 工作树时，如果其名称不是 src，则 enlistment 将与工作树相同。
scalar 命令实现了各种子命令，并且根据子命令有不同的选项。除了 clone、list 和 reconfigure --all 之外，所有子命令都期望在 enlistment 中运行。
以下选项可以在子命令之前指定
命令
Clone
- clone [<options>] <url> [<enlistment>]
-
克隆指定的仓库，类似于 git-clone[1]。默认情况下，仅克隆提交和树对象。完成后，工作树位于 <enlistment>
/src。稀疏检出功能已启用（除非与
--full-clone一起运行），并且仅存在顶层目录中的文件。使用git sparse-checkout set展开您想要查看的目录集，或使用git sparse-checkout disable展开到所有文件（有关更多详细信息，请参阅 git-sparse-checkout[1]）。您可以使用git ls-tree HEAD[:<directory>]来探索稀疏检出之外的子目录。 - -b <name>
- --branch <name>
-
代替检出克隆仓库 HEAD 指向的分支，而是检出 <name> 分支。
- --single-branch
- --no-single-branch
-
仅克隆指向单个分支尖端的历史记录，该分支由
--branch选项指定，或由远程的HEAD指向的主分支。对结果仓库的进一步获取将仅更新用于初始克隆时使用此选项的分支的远程跟踪分支。如果在进行
--single-branch克隆时，远程的 HEAD 未指向任何分支，则不会创建远程跟踪分支。 - --src
- --no-src
-
默认情况下，
scalar clone将克隆的仓库放置在 <entlistment>/src目录内。使用--no-src将克隆的仓库直接放置在 <enlistment> 目录中。 - --tags
- --no-tags
-
默认情况下，
scalar clone将获取远程提供的标签对象，并且未来的git fetch命令也将如此。使用--no-tags避免在scalar clone中获取标签，并配置仓库以避免将来获取标签。要使用--no-tags克隆后获取标签，请运行git fetch --tags。 - --full-clone
- --no-full-clone
-
默认初始化稀疏检出。此行为可以通过
--full-clone关闭。 - --maintenance
- --no-maintenance
-
默认情况下，
scalar clone配置 enlistment 以使用 Git 的后台维护功能。使用--no-maintenance跳过此配置。
Register
- register [<enlistment>]
-
将 enlistment 的仓库添加到注册仓库列表并开始后台维护。如果未提供 <enlistment>，则注册与当前工作目录关联的 enlistment。
注意：当此子命令在名为
src/的工作树中调用时，其父目录被视为 Scalar enlistment。如果工作树不名为src/，则它本身将被视为 Scalar enlistment。 - --maintenance
- --no-maintenance
-
默认情况下，
scalar register配置 enlistment 以使用 Git 的后台维护功能。使用--no-maintenance跳过此配置。这不会禁用任何可能已通过其他方式启用的维护。
Run
- scalar run ( all | config | commit-graph | fetch | loose-objects | pack-files ) [<enlistment>]
-
运行给定的维护任务（如果指定了 all，则运行所有任务）。除了 all 和 config 之外，此子命令直接移交给 git-maintenance[1]（将 fetch 映射到 prefetch，将 pack-files 映射到 incremental-repack）。
这些任务作为计划维护的一部分自动运行，一旦仓库被注册到 Scalar。因此，不应手动运行此子命令。
config任务是 Scalar 特有的，它配置了所有那些能够让 Git 更高效地处理大型仓库的默认设置。由于此任务会自动作为scalar clone的一部分运行，因此很少需要显式调用此任务。