# 使用前必读

1.工蜂TSVN支持 Windows图形客户端 与 macOS命令行 两种形式

2.安装工蜂TSVN客户端后,将替换已安装的社区版TortoiseSVN客户端

# Windows 客户端

# 首次安装

可访问工蜂TSVN官网下载最新的软件包、语言包(可选):https://git.tencent.com/home/tsvn

安装方法和过程与社区版TortoiseSVN无异。如果需要使用命令行,安装时请选上 comand line client tools。

注意:如果安装时遇到安全软件告警,请选择"允许"。

# 升级版本

如果你已安装了工蜂TSVN,那么会收到主动推送的新版本升级提示,点击软件下载链接进行下载安装;

或者 右键"TortoiseSVN > about > Check For Update",如果有新版本,点击软件下载链接进行下载安装。

# macOS 命令行工具

适用于macOS构建机场景,安装与使用方法如下:

# 首次安装

1.一般macOS机器默认安装了原生svn,请先 unlink 并卸载:

brew unlink subversion  

brew uninstall subversion

2.然后通过下面的命令安装:

brew tap gfsvn/tap && brew install gfsvn

3.安装后通过 svn --version 查看版本,显示 1.15.x 及以上版本即安装成功。

# 升级版本

如果你已经安装过工蜂TSVN的macOS命令行工具,可以通过下面的命令升级版本:

brew update
brew reinstall gfsvn/tap/gfsvn

# 常见问题

1.运行时报错:bad CPU type in executable: svn

工蜂 Mac 客户端为 x86_64(Intel)架构编译版本。若 Mac 为 Apple Silicon(ARM64)架构,首次运行前需安装 Rosetta 2 兼容层,以支持运行 x86_64 程序。

可执行以下命令安装:

softwareupdate --install-rosetta --agree-to-license

2.安装时报错:Your Command Line Tools (CLT) does not support macOS xx.或Xcode alone is not sufficient on xx.

需要升级CLT:

sudo rm-rf /Library/Developer/CommandLineToolssudo xcode-select --install
lastUpdate: 9/23/2026, 2:27:27 PM