# 解救国内开发者，全平台换源工具：Chsrc

> 本文开放前 70% 正文，剩余内容会员可见。

原文：https://utgd.net/article/20900

国内的开发者经常遇到的一个问题是，在部署开发环境时受限于网络带宽和防火墙等原因，经常面临镜像源访问缓慢、连接不稳定的问题，导致软件包拉取不下来。比如 python 开发需要 pip 源、node 开发需要 npm 源、部署 Docker 需要 Docker 源。

每次手动解决这些问题不仅浪费时间，还会导致开发进程被打断，有时候只是想装个扩展，却要等很久才能安装完毕，很影响开发体验和效率。

而且，本地开发环境想解决问题，尚可以通过网络代理的方法解决。但在生产环境的服务器中，总不能也通过网络代理解决吧。所以通常的解决方法是：更换源、自建源、离线转移。

为了提高开发效率，一个能够快速切换镜像源的工具就变得尤为重要了。

🔗 Chsrc \- Github

Chsrc 就是这样一个面向开发者的全平台命令行换源工具。它是一个专门为开发者设计的换源工具，通过一套简单的命令行操作，让开发者能够快速切换到最快的国内镜像源。

## 如何安装 chsrc

最直观的当然在 Github Release 页面直接下载最新版本。

🔗 Chsrc \- Github Releases 下载

你也可以通过命令行安装。

macOS 可通过 homebrew 安装——

```
$ brew install chsrc
```

或手动下载二进制文件，这是最新版，往往比 homebrew 提供的更新，适用于修复 Bug、添加新功能后及时使用。（未安装 homebrew 时推荐这种方法）

```
# arm/aarch64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-aarch64-macos -o chsrc; chmod +x ./chsrc

# x64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-macos -o chsrc; chmod +x ./chsrc
```

Windows 可通过 scoop 安装——

```
$ scoop install chsrc
```

或手动下载二进制文件，这是最新版，往往比 scoop 提供的更新，适用于修复 Bug、添加新功能后及时使用。（未安装 scoop 时推荐这种方法）

```
# x64
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x64-windows.exe -o chsrc.exe

# x86
curl -L https://gitee.com/RubyMetric/chsrc/releases/download/pre/chsrc-x86-windows.exe -o chsrc.exe
```

Linux、BSD 等其他平台可以参考项目 README 文档了解使用方法。

下载下来后是一个单独的文件。你可以直接在这个目录下继续执行命令来换源，也可以添加到系统环境变量中，方便在任意位置执行 chsrc 命令。

## 如何使用 chsrc

接下来是具体使用。Chsrc 的操作非常直观。开发者只需通过简单的几行命令，就可以实现镜像源的快速切换。

比如我想为 Python 更换源，可以输入 chsrc list 命令来检查有哪些可用的源。

```
chsrc list python
```

接下来输入 chsrc set 命令，为这些源进行测速、寻找最快的源、换源。非常方便。

```
chsrc set python
```

如果你只想换到最快的源，则在后面再加上 first。

```
chsrc set python first
```

如果你想恢复到默认的源，用 reset 就可以重置为默认源。

```
chsrc reset python
```

如果你的开发团队有自己维护的内部源，也可以用 chsrc 进行手动指定。

```
# 切换到自己的镜像地址
chsrc set ruby https://gems.ruby-china.com/ # 使用自定义URL
```

此外，Chsrc 还支持对支持项目级换源的工具（如 bundler、pdm 等）进行局部换源，避免全局换源带来的风险和麻烦。这样

---

[前往标准阅读页](https://utgd.net/article/20900?audience=web)