一键配置国内开发环境镜像源，解决 npm、pip、go、docker、cargo 等工具下载慢、超时的问题。支持 npm、yarn、pnpm、pip、Go (GOPROXY)、Docker、Cargo、Maven、Gradle、Homebrew 镜像源切换。适用场景：用户说“配置镜像源”等。
CN Dev Setup — 国内开发环境镜像源配置
功能概述
CN Dev Setup — 国内开发环境镜像源配置是一项面向实际任务的技能，主要用于解决国内开发者最大的痛点：下载慢、超时、连不上；一键切换到国内镜像源；
核心要点
- 支持的工具；
- npm/yarn/pnpm；
- 淘宝 npmmirror；
使用与执行
npm config set registry https://registry.npmmirror.com；清华 TUNA / 阿里云；pip config set global.inde。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
结果检查与注意事项
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
CN Dev Setup — 国内开发环境镜像源配置
解决国内开发者最大的痛点：下载慢、超时、连不上。一键切换到国内镜像源。
支持的工具
| 工具 | 镜像源 | 命令 |
|---|---|---|
| npm/yarn/pnpm | 淘宝 npmmirror | npm config set registry https://registry.npmmirror.com |
| pip | 清华 TUNA / 阿里云 | pip config set global.index-url |
| Go (GOPROXY) | 七牛 goproxy.cn | go env -w GOPROXY=https://goproxy.cn,direct |
| Docker | 多个可选（阿里云/中科大/Docker proxy） | 修改 daemon.json |
| Cargo (Rust) | 清华 TUNA / 中科大 | 修改 ~/.cargo/config.toml |
| Maven | 阿里云 maven | 修改 settings.xml |
| Gradle | 阿里云 maven | 修改 build.gradle |
| Homebrew | 清华 TUNA | 环境变量设置 |
| Git | 代理配置 | git config --global http.proxy |
Quick Start
自动配置（推荐）
python/scripts/setup_mirrors.py --all
一键配置所有已安装工具的镜像源。
按工具配置
python/scripts/setup_mirrors.py npm pip go docker
只配置指定的工具。
查看当前状态
python/scripts/setup_mirrors.py --status
检查每个工具当前使用的源，标注哪些还是国外源。
恢复默认源
python/scripts/setup_mirrors.py --reset npm pip
恢复到官方默认源。
使用指南
交互模式
当用户说"配置镜像源"或"npm太慢"时：
- 运行
--status检查当前源配置 - 列出需要切换的工具
- 确认后执行切换
- 验证切换结果
Git 代理配置
如果用户有 HTTP 代理（如 clash/v2ray）：
# 全局代理 git config --global http.proxy http://127.0.0.1:7890 git config --global https.proxy http://127.0.0.1:7890 # 仅 GitHub 代理（推荐） git config --global http.https://github.com.proxy http://127.0.0.1:7890
Docker 镜像源
Docker daemon.json 位置：
- Linux:
/etc/docker/daemon.json - macOS:
~/.docker/daemon.json - Windows:
%USERPROFILE%.dockerdaemon.json或 Docker Desktop 设置
镜像源详情
见 references/mirrors.md 获取完整的镜像源列表、备选源和测速方法。
故障排查
| 问题 | 原因 | 解决方案 |
|---|---|---|
| npm install 仍然慢 | 缓存了旧源地址 | npm cache clean --force 后重试 |
| pip 提示证书错误 | 公司网络 MITM | 加 --trusted-host pypi.tuna.tsinghua.edu.cn |
| docker pull 超时 | daemon.json 格式错误 | 检查 JSON 格式，重启 Docker 服务 |
| go mod download 失败 | GONOSUMDB 未设置 | go env -w GONOSUMDB=* 跳过校验 |
| Cargo 编译慢 | crates.io 索引大 | 用 sparse 协议：sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/ |
| Maven 仍用中央仓库 | settings.xml 位置不对 | 确认文件在 ~/.m2/settings.xml |
| 切换后部分包仍慢 | 镜像同步延迟 | 等几小时或换备选源 |
| 恢复默认源后异常 | 缓存残留 | 清除对应工具缓存目录 |
相关专题
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
2026.10.22
0
15
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
2026.10.22
0
12
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 133.9万人学习
共49课时 | 82.5万人学习
