Sublarge

// Windows · 2024-11-09

告别换源抓狂！chsrc 全平台一键换源工具（python,go,nodejs,ruby)

chsrc是一款全平台通用的换源工具，支持Python、Node.js、Go等数十种开发工具。核心功能包括自动测速、一键切换和自定义源配置，彻底解决开发者配置镜像源的痛点。安装方式简单，Windows可通过scoop或下载二进制文件，macOS/Linux通过curl一键安装。使用命令统一，如chsrc use python自动切换最快pip源，chsrc test node测试npm源速度。该工具显著提升开发效率，是配置开发环境的理想解决方案。

换源编程开发语言

作为开发者，配置开发环境时的“换源噩梦”几乎人人都经历过：网上搜到的镜像源要么失效无法使用，要么切换步骤繁琐，不同语言、工具的换源命令五花八门，更让人头疼的是，根本不知道哪个源速度最快，往往在反复测试中浪费大量时间。前几天偶然发现了一款全平台通用的换源工具 chsrc，实测后发现它彻底解决了这些痛点——自动测速、一键切换、支持自定义源，操作简单到扔给宿舍群后，所有人都直呼“真香”。今天就详细分享它的安装和使用方法，帮大家彻底告别换源烦恼。

一、chsrc 是什么？

chsrc 是一款跨 Windows、macOS、Linux 的全平台换源工具与框架，支持 Python（pip）、Node.js（npm/yarn）、Go（go mod）、Ruby（gem）、Docker、Homebrew 等数十种开发工具和包管理器。它的核心优势在于：

  • 自动测速：内置多个优质镜像源，一键测试并切换到最快源；
  • 操作极简：无需记忆复杂命令，统一语法实现所有工具换源；
  • 灵活扩展：支持添加自定义镜像源（如自建反代源）；
  • 全平台兼容：Windows、macOS、Linux 无缝适配，无需区分系统差异。

项目地址：https://github.com/RubyMetric/chsrc

二、快速安装

1. Windows 系统（两种方式）

方式 1：通过 scoop 安装（推荐，快速便捷）

如果未安装 scoop（Windows 包管理器），先执行以下命令安装：

iwr -useb get.scoop.sh | iex
powershell1 行

安装完成后，执行以下命令安装 chsrc：

scoop install chsrc
powershell1 行

注意：scoop 可能存在更新延迟，若无法获取最新版本，可选择方式 2。

方式 2：直接下载二进制文件

通过 PowerShell 脚本一键下载最新版二进制文件：

"& { $(iwr -useb https://chsrc.run/windows) } -Version pre" | iex
powershell1 行

2. macOS/Linux 系统

通过 curl 直接下载并安装（自动适配系统架构）：

curl https://chsrc.run/posix | sudo bash
bash1 行

安装完成后，在终端输入 chsrc，若显示帮助信息，则说明安装成功。

三、核心用法

chsrc 的命令语法极其统一，核心格式为：

  • 自动测速并切换最快源：chsrc use <工具名>
  • 手动设置指定源：chsrc set <工具名> <源地址>
  • 测试所有源速度：chsrc test <工具名>
  • 查看可用源列表：chsrc list <工具名>
  • 重置为默认源：chsrc reset <工具名>

下面以 Python、Node.js、Go、Ruby 为例，详细演示日常使用场景。

1. Python（pip 换源）

场景 1：一键切换最快源

无需手动查找源地址，chsrc 会自动测试国内优质镜像源（如清华、阿里、豆瓣）并切换：

# Windows/macOS/Linux 通用命令
chsrc use python
bash2 行

执行后，工具会自动完成“检查 pip 是否存在 → 测试所有内置源速度 → 切换到最快源”的全流程，终端会显示测速结果和切换状态，全程无需手动干预。

场景 2：添加自定义源（如自建反代源）

若需使用特定镜像源（如公司内部自建源、速度更快的反代源），执行以下命令：

chsrc set python https://your.custom.pip.source
# 示例：使用公司自建源
chsrc set python https://pip.company.com/simple
bash3 行

场景 3：手动测速对比

想直观查看不同源的速度差异，可执行测速命令：

chsrc test python
bash1 行

终端会以列表形式展示所有内置源的响应时间（单位：毫秒），并高亮显示最快源，结果清晰易懂——实测发现，有时非知名源的速度反而超过清华、阿里源。

2. Node.js（npm/yarn 换源）

场景 1：一键切换最快 npm 源

# 切换 npm 最快源（自动适配 yarn）
chsrc use node
bash2 行

执行后，工具会自动配置 npm 的 registry 地址，同时兼容 yarn（若已安装 yarn，会同步更新 yarn 源），无需单独操作。

场景 2：设置自定义 npm 源

chsrc set node https://your.custom.npm.source
# 示例：使用淘宝 npm 镜像（手动指定）
chsrc set node https://registry.npmmirror.com
bash3 行

场景 3：测试 npm 源速度

chsrc test node
bash1 行

终端会展示所有内置 npm 源的测速结果，相比 Python 的源，npm 可用公共源数量较少，若你有优质公共源，可通过官方渠道贡献。

3. Go（go mod 换源）

Go mod 的默认源在国内访问较慢，且常出现拉取失败问题，chsrc 可一键切换到国内优质镜像源（如七牛云、阿里云）。

场景 1：一键切换最快源

# 自动测试并切换 go mod 最快源
chsrc use go
bash2 行

工具会自动配置 GOPROXY 环境变量，无需手动编辑系统环境变量，切换后立即生效（新终端窗口无需重启）。

场景 2：设置自定义 GOPROXY

chsrc set go https://your.custom.goproxy.source
# 示例：使用自建 GOPROXY 源
chsrc set go https://goproxy.company.com
bash3 行

场景 3：查看可用 Go 源列表

chsrc list go
bash1 行

终端会显示所有内置的 Go 镜像源，包括源地址、是否支持 HTTPS、是否包含代理缓存等信息，方便按需选择。

4. Ruby（gem 换源）

Ruby 的默认 gem 源在国内访问速度极慢，且容易出现连接超时，chsrc 可快速切换到国内镜像源（如 Ruby China）。

场景 1：一键切换最快源

# 自动测试并切换 gem 最快源
chsrc use ruby
bash2 行

执行后，工具会自动更新 gem 的源地址，替代默认的 https://rubygems.org/，后续执行 gem install 时速度会显著提升。

场景 2：设置自定义 gem 源

chsrc set ruby https://your.custom.gem.source
# 示例：使用 Ruby China 源（手动指定）
chsrc set ruby https://gems.ruby-china.com
bash3 行

场景 3：重置为默认 gem 源

若需恢复 Ruby 官方默认源，执行：

chsrc reset ruby
bash1 行

chsrc list

四、总结

使用 chsrc 工具的优点在于，它可以显著提高开发效率。对于熟练用户，能够快速切换到最快的源和自定义源，从而节省大量时间。对于不熟悉命令行的用户，chsrc 提供了简单易用的基础命令，使得换源变得轻松，降低了操作门槛。如果你还在为换源抓狂，不妨试试 chsrc，它不会让你失望——毕竟，开发的时间应该用在核心业务上，而不是浪费在环境配置上。

原文 https://blog.csdn.net/2301_79518550/article/details/143653554