Facebook Sapling 版本控制系统安装指南

Facebook Sapling 版本控制系统安装指南

sapling A Scalable, User-Friendly Source Control System. 项目地址: https://gitcode.com/gh_mirrors/sa/sapling

前言

Facebook Sapling 是一个现代化的分布式版本控制系统，专为处理大型代码库而设计。相比传统版本控制工具，Sapling 提供了更高效的代码管理体验，特别适合企业级项目开发。本文将详细介绍 Sapling 在不同操作系统上的安装方法。

系统要求

在开始安装前，请确保您的系统满足以下基本要求：

• macOS: 10.15 (Catalina) 或更高版本
• Windows: Windows 10 或更高版本
• Linux: 主流发行版（Ubuntu 20.04/22.04、Arch Linux 等）

预编译二进制安装

macOS 安装

方法一：通过 Homebrew 安装

对于大多数 macOS 用户，推荐使用 Homebrew 进行安装：

brew install sapling

这种方法简单快捷，会自动处理所有依赖关系。

方法二：手动安装预编译包

对于 Apple Silicon (M1/M2) 用户，可以下载特定架构的预编译包：

1. 下载安装包：

curl -L -o sapling-<version>-arm64_big_sur.bottle.tar.gz <下载地址>

2. 安装：

brew install ./sapling-<version>-arm64_big_sur.bottle.tar.gz

重要提示：如果通过浏览器下载，MacOS 可能会标记为"不受信任"，需要执行：

xattr -r -d com.apple.quarantine ~/Downloads/sapling-<version>-arm64_big_sur.bottle.tar.gz

3. 优化文件打开限制（推荐）：

echo "ulimit -n 1048576" >> ~/.bash_profile
echo "ulimit -n 1048576" >> ~/.zshrc

Windows 安装

1. 下载最新版本的 Windows ZIP 包
2. 以管理员身份运行 PowerShell 执行：

Expand-Archive ~/Downloads/sapling_windows.zip 'C:\Program Files'

3. 添加环境变量：

setx PATH "$env:PATH;C:\Program Files\Sapling" -m

4. 解决 PowerShell 命令冲突：

Set-Alias -Name sl -Value 'C:\Program Files\Sapling\sl.exe' -Force -Option Constant,ReadOnly,AllScope

依赖工具：

• Git for Windows：用于与 Git 仓库交互
• Node.js (v16+)：支持 Web 界面功能

Linux 安装

Ubuntu 22.04

curl -L -o sapling_<version>_amd64.Ubuntu22.04.deb <下载地址>
sudo apt install -y ./sapling_<version>_amd64.Ubuntu22.04.deb

Arch Linux (通过 AUR)

yay -S sapling-scm-bin

其他发行版

可以通过 Homebrew 安装：

brew install sapling

从源代码构建

构建环境准备

需要安装以下工具：

• Make
• g++
• Rust 工具链
• Node.js
• Yarn

构建步骤

macOS/Linux

git clone <仓库地址>
cd <仓库目录>/eden/scm
make oss
./sl --help

FreeBSD

pkg install gmake terminfo-db
export TERMINFO=/usr/local/share/terminfo
git clone <仓库地址>
cd <仓库目录>/eden/scm
gmake oss
./sl --help

Windows

1. 安装 vcpkg 管理依赖
2. 执行构建：

git clone <仓库地址>
cd <仓库目录>\eden\scm
git config --system core.longpaths true
python3 .\packaging\windows\build_windows_zip.py
.\build\embedded\sl.exe --help

安装后配置

安装完成后，建议执行以下操作：

1. 验证安装：运行 sl --version 确认版本信息
2. 配置用户信息：设置用户名和邮箱
3. 熟悉基本命令：sl help 查看可用命令

常见问题

1. macOS 权限问题：如遇权限错误，检查 Gatekeeper 设置
2. Windows 路径问题：确保 PATH 变量正确设置
3. Linux 依赖缺失：根据错误提示安装缺少的库

结语

Sapling 提供了多种灵活的安装方式，用户可以根据自己的环境选择最适合的方法。预编译二进制适合快速部署，而从源代码构建则适合需要自定义配置的高级用户。安装完成后，您就可以开始体验 Sapling 强大的版本控制功能了。

sapling A Scalable, User-Friendly Source Control System. 项目地址: https://gitcode.com/gh_mirrors/sa/sapling