cli配置的核心逻辑只有一句话：命令行参数优先于环境变量，环境变量优先于配置文件，配置文件优先于工具默认值。 理解这层优先级，大部分配置问题都能自己排查。
cli配置怎么设置：先分清三个层级
不少开发者第一次接触命令行工具时,总把配置写得东一块西一块，其实cli配置就三个层级，搞清楚它们的位置和作用，配置就不会乱。
- 命令行参数：单次执行时临时指定，
npm install --registry=https://registry.npmmirror.com - 环境变量：当前终端会话有效，适合临时切换身份或代理，
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com - 配置文件：持久化保存，每次启动自动加载，
.npmrc、.gitconfig
这三个层级从上到下优先级依次降低,命令行参数会覆盖环境变量，环境变量会覆盖配置文件，行业共识认为，专业开发者的配置策略应当是：默认用配置文件，临时改用环境变量，单次测试用命令行参数。
配置文件该放在哪里
不同工具的配置文件位置差异很大,但一般遵循“全局、用户、项目”三级查找机制，以npm为例：
- 全局配置：
/etc/npmrc或C:\Program Files\nodejs\npmrc - 用户级配置：
~/.npmrc - 项目级配置：
./.npmrc
项目级配置优先级最高,会覆盖用户级和全局配置，你可以用 npm config get userconfig 查看当前用户配置路径，git的查找机制类似，但git没有项目级“配置目录”，而是用 .git/config 管理单个仓库。
常见工具配置项怎么改
配置项修改通常有命令和编辑文件两种方式,推荐用命令，因为能自动处理格式和路径。
- npm：
npm config set registry https://registry.npmmirror.com - git：
git config --global user.name "yourname" - pip：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
命令修改会直接写入对应用户级配置文件,用命令操作比手改文件更安全，尤其对于JSON或YAML格式的配置。
npm与yarn的cli配置对比：优先级和文件位置差异
很多前端项目同时用到npm和yarn,两者配置逻辑相近但文件格式不同，下面用表格做个直观对比。
| 对比项 | npm | yarn classic | yarn berry |
|---|---|---|---|
| 配置文件 | .npmrc |
.yarnrc |
.yarnrc.yml |
| 环境变量前缀 | npm_config_ |
yarn_ |
YARN_ |
| 查看配置 | npm config list |
yarn config list |
yarn config list |
| 设置配置 | npm config set key value |
yarn config set key value |
yarn config set key value |
| 项目级配置 | 支持 .npmrc |
支持 .yarnrc |
支持 .yarnrc.yml |
npm的配置项兼容性最广,几乎所有依赖安装场景都能通过 .npmrc 解决，yarn berry 用YAML格式，结构更清晰，但老项目迁移成本较高，业内专家指出，选择工具时不必纠结配置语法差异，团队统一才是第一位。
国内镜像cli配置教程：从慢到快的关键步骤
国内网络环境下,默认官方源经常超时，多数情况下，改镜像源是提升安装速度最直接的方式，下面列出几个常用工具的镜像配置命令。
- npm：
npm config set registry https://registry.npmmirror.com - yarn classic：
yarn config set registry https://registry.npmmirror.com - pip：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple - docker：修改
/etc/docker/daemon.json，添加"registry-mirrors"字段 - go：
go env -w GOPROXY=https://goproxy.cn,direct
配置国内镜像后,最好验证一下是否生效。
- npm：
npm config get registry - pip：
pip config list - go：
go env GOPROXY
验证命令能直接看到当前生效的源地址,如果输出还是官方地址，说明配置文件没写对位置，或者被环境变量覆盖了。
免费cli配置工具推荐：零成本也能高效管理
命令行工具本身多数免费,但配置管理可以借助一些开源小工具来提升效率，这里推荐几个免费方案。
- direnv：进入项目目录自动加载环境变量，离开时自动卸载，适合管理不同项目之间的密钥。
- dotenv-cli：用
.env文件统一管理环境变量，配合任意命令执行。 - commander：Node.js 下快速构建带参数解析的CLI工具。
- yargs：功能更丰富的参数解析库，支持子命令和配置自动补全。
- oclif：Salesforce开源的CLI框架，自带配置管理和插件机制。
免费工具覆盖配置管理、参数解析和命令行交互，付费方案通常增加团队协作、审计日志和图形化配置同步，对个人或小团队来说，免费方案足够解决绝大多数场景。
Windows下cli配置方法：别直接照搬Linux命令
Windows终端和Linux终端的环境变量设置方式完全不同,很多教程里的 export 命令在Windows cmd下会直接报错。
- cmd：
set NPM_CONFIG_REGISTRY=https://registry.npmmirror.com - PowerShell：
$env:NPM_CONFIG_REGISTRY="https://registry.npmmirror.com" - 持久化环境变量：
setx NPM_CONFIG_REGISTRY "https://registry.npmmirror.com"
PowerShell的 $env: 只对当前会话有效，要永久生效，用 setx 命令，但要注意 setx 不会影响当前已打开的终端，需要重开窗口。
Windows下配置文件路径也有差异,比如npm在Windows下用户级配置位于
C:\Users\用户名\.npmrc，而不是Linux的 ~/.npmrc，用 npm config get userconfig 查看真实路径是最稳的方式。
用别名和自动补全优化cli配置体验
配置好基础项后,日常使用还可以通过别名和自动补全来减少输入。
- git别名：
git config --global alias.co checkout - shell别名：
alias g='git'、alias k='kubectl' - kubectl自动补全：
source <(kubectl completion bash) - npm自动补全：
npm completion >> ~/.bashrc
自动补全脚本需要根据你的shell类型来配置,zsh用户可以用oh-my-zsh插件，bash用户用 source 命令加载，配置一次，长期受益。
cli配置不是一劳永逸的事,环境变化、项目迁移、团队协作时，优先检查配置文件是否被更上层的环境变量或命令行参数覆盖，把这层关系理顺，绝大多数配置报错都能快速定位。
cli配置常见问题解答
cli配置怎么设置全局代理才能同时兼容内网和公网？
通过环境变量 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 组合设置。NO_PROXY 用来排除内网地址，避免代理干扰内部服务，多数主流CLI工具都遵循这三个环境变量，优先级同样遵循命令行参数高于环境变量高于配置文件。
免费cli配置工具和付费方案的关键区别是什么？
免费工具覆盖配置管理、参数解析和命令行交互，开源社区活跃，付费方案通常增加团队协作、审计日志、图形化配置同步和权限控制，对于单人或小团队，免费工具足够；大型团队或合规要求高的场景，才需要考虑付费方案。
cli配置如何快速恢复默认值？
删除或重命名对应配置文件即可回到默认状态,npm可以用 npm config delete key 删除单个配置项，git可以用 git config --unset key，恢复默认后需重新打开终端让变更生效。