mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-08-04 19:45:34 +08:00
Jason
bbed2a1fe1
Reorganize docs/user-manual/ from flat structure to language subdirectories (zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/, fix image paths, add multilingual navigation README, and translate all 23 markdown files (~4500 lines each) to English and Japanese.
109 lines
2.6 KiB
Markdown
109 lines
2.6 KiB
Markdown
# 5.4 环境变量冲突
|
||
|
||
## 功能说明
|
||
|
||
CC Switch 会自动检测系统环境变量与应用配置的冲突，避免配置被意外覆盖。
|
||
|
||
**检测的环境变量**：
|
||
- `ANTHROPIC_API_KEY` - Claude API 密钥
|
||
- `ANTHROPIC_BASE_URL` - Claude API 端点
|
||
- `OPENAI_API_KEY` - OpenAI API 密钥
|
||
- `GEMINI_API_KEY` - Gemini API 密钥
|
||
- 其他相关环境变量
|
||
|
||
## 冲突警告
|
||
|
||
当检测到冲突时，界面顶部会显示黄色警告横幅：
|
||
|
||
```
|
||
⚠️ 检测到环境变量冲突
|
||
发现 X 个环境变量可能与 CC Switch 配置冲突
|
||
[展开] [关闭]
|
||
```
|
||
|
||
## 查看冲突详情
|
||
|
||
点击「展开」按钮查看详细信息：
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 变量名 | 环境变量名称 |
|
||
| 变量值 | 当前设置的值 |
|
||
| 来源 | 变量的来源位置 |
|
||
|
||
### 来源类型
|
||
|
||
| 来源 | 说明 |
|
||
|------|------|
|
||
| 用户注册表 | Windows 用户级环境变量 |
|
||
| 系统注册表 | Windows 系统级环境变量 |
|
||
| Shell 配置 | macOS/Linux 的 shell 配置文件 |
|
||
| 系统环境 | 系统级环境变量 |
|
||
|
||
## 处理冲突
|
||
|
||
### 选择要删除的变量
|
||
|
||
1. 勾选要删除的环境变量
|
||
2. 或点击「全选」选择所有冲突变量
|
||
|
||
### 删除变量
|
||
|
||
1. 点击「删除选中」按钮
|
||
2. 确认删除操作
|
||
3. CC Switch 会自动备份并删除选中的变量
|
||
|
||
### 自动备份
|
||
|
||
删除前会自动备份：
|
||
|
||
- 备份位置：`~/.cc-switch/env-backups/`
|
||
- 备份格式：JSON 文件
|
||
- 包含变量名、值、来源等信息
|
||
|
||
## 忽略警告
|
||
|
||
如果确认冲突不影响使用，可以：
|
||
|
||
1. 点击警告横幅右侧的「关闭」按钮
|
||
2. 警告会暂时隐藏
|
||
3. 下次启动时会重新检测
|
||
|
||
## 手动处理
|
||
|
||
如果不想通过 CC Switch 删除，可以手动处理：
|
||
|
||
### Windows
|
||
|
||
1. 打开「系统属性 → 高级 → 环境变量」
|
||
2. 在用户变量或系统变量中找到冲突变量
|
||
3. 删除或修改变量
|
||
|
||
### macOS / Linux
|
||
|
||
1. 编辑 shell 配置文件（如 `~/.zshrc`、`~/.bashrc`）
|
||
2. 删除或注释掉相关的 `export` 语句
|
||
3. 重新加载配置：`source ~/.zshrc`
|
||
|
||
## 为什么会冲突
|
||
|
||
环境变量的优先级通常高于配置文件，可能导致：
|
||
|
||
- CC Switch 设置的供应商配置被覆盖
|
||
- API 请求发送到错误的端点
|
||
- 使用错误的 API 密钥
|
||
|
||
## 最佳实践
|
||
|
||
1. **使用 CC Switch 管理配置**：避免在系统环境变量中设置 API 密钥
|
||
2. **定期检查**：关注冲突警告，及时处理
|
||
3. **备份重要变量**：删除前确认已备份
|
||
|
||
## 恢复已删除的变量
|
||
|
||
如果误删了环境变量：
|
||
|
||
1. 找到备份文件：`~/.cc-switch/env-backups/`
|
||
2. 打开对应的 JSON 文件
|
||
3. 手动恢复变量到系统环境
|