change-source/README.md

change-source

[English | 中文]

A simple and interactive CLI tool to quickly switch package manager registries (npm, yarn, pnpm), supporting both English and Chinese. 一款简单交互式的包管理器源一键切换工具，支持 npm/yarn/pnpm，支持中英文界面。

Features 特性

• One-click switch registry for npm, yarn, pnpm
• Interactive CLI, easy to use
• Built-in English and Chinese support (auto-detects system, or specify via flag)
• Supports common registries (official, Taobao, CNPM, etc) and custom registries (custom registries are persistent; you can delete them via --delete / -d)
• Fast npx usage, or install globally

Installation 安装

Recommended 推荐用法（全局安装）：

npm install -g @whtg/change-source
# 然后使用
change-source

或（无需全局安装，临时使用最新版）：

npx @whtg/change-source
# 或指定最新版
npx @whtg/change-source@latest

Usage 使用

English

Global Install Usage (Recommended)

change-source                   # Interactive registry switch for all (npm/yarn/pnpm)
change-source --npm             # Only switch npm registry
change-source --yarn            # Only switch yarn registry
change-source --pnpm            # Only switch pnpm registry

change-source --all --to taobao        # Switch all sources to Taobao registry
change-source --npm --to official      # Switch npm to official registry

change-source --list           # Show available registries
change-source --delete         # Delete custom registries

change-source -d               # (shorthand, same as --delete)

change-source --lang en        # Force interface language to English
change-source --lang zh        # Switch to Chinese interface

change-source --show           # Show current registries for all managers

npx (No Global Install)

npx @whtg/change-source                   # Interactive registry switch for all (npm/yarn/pnpm)
npx @whtg/change-source --npm             # Only switch npm registry
npx @whtg/change-source --yarn            # Only switch yarn registry
npx @whtg/change-source --pnpm            # Only switch pnpm registry

npx @whtg/change-source --all --to taobao        # Switch all sources to Taobao registry
npx @whtg/change-source --npm --to official      # Switch npm to official registry

npx @whtg/change-source --list           # Show available registries
npx @whtg/change-source --delete         # Delete custom registries

npx @whtg/change-source -d               # (shorthand, same as --delete)

npx @whtg/change-source --lang en        # Force interface language to English
npx @whtg/change-source --lang zh        # Switch to Chinese interface

npx @whtg/change-source --show           # Show current registries for all managers

中文

全局安装命令（推荐）

change-source                   # 进入交互，一键切换全部源
change-source --npm             # 只切换 npm 源
change-source --yarn            # 只切换 yarn 源
change-source --pnpm            # 只切换 pnpm 源

change-source --all --to taobao        # 全部切换为淘宝源
change-source --npm --to official      # 只切 npm 源为官方源

change-source --list           # 列出可用源

change-source --delete         # 删除自定义源
change-source -d               # （短写，与 --delete 效果一致）

change-source --lang zh        # 强制切换中文界面
change-source --lang en        # Switch to English interface

change-source --show           # 查看所有包管理器当前源地址

npx 使用（无需全局安装）

npx @whtg/change-source                   # 进入交互，一键切换全部源
npx @whtg/change-source --npm             # 只切换 npm 源
npx @whtg/change-source --yarn            # 只切换 yarn 源
npx @whtg/change-source --pnpm            # 只切换 pnpm 源

npx @whtg/change-source --all --to taobao        # 全部切换为淘宝源
npx @whtg/change-source --npm --to official      # 只切 npm 源为官方源

npx @whtg/change-source --list           # 列出可用源

npx @whtg/change-source --delete         # 删除自定义源
npx @whtg/change-source -d               # （短写，与 --delete 效果一致）

npx @whtg/change-source --lang zh        # 强制切换中文界面
npx @whtg/change-source --lang en        # 切换为英文界面

npx @whtg/change-source --show           # 查看所有包管理器当前源地址

Supported Registries 支持的默认源

• official 官方源
• taobao 淘宝镜像
• cnpm CNPM 镜像
• (Custom 任意自定义)

FAQ

Q: Is it safe to use? 会破坏我的配置吗？ A: This tool only runs official config set commands like npm config set registry ... and does NOT delete or corrupt your other settings. 本工具只会调用官方的 registry 配置命令，并不会破坏你的其他设置。

Q: How does the language switch work? 语言如何切换？ A: The tool auto-detects your system with LANG/LC_ALL or you may use --lang zh or --lang en explicitly. 工具会自动检测环境变量，也可通过 --lang 参数强制指定。

Contribution 贡献

Feel free to submit Pull Requests for more features or new registries.

欢迎 PR，共同完善功能与新的镜像源方案！

License

MIT

更新日志

1.0.5

• 优化文档说明：精简结构和描述，提升可读性。