学习笔记2：《Deep Code 配置教程：写给 Windows 11 小白的避坑指南》

原文档一句话带过 ~/.deepcode/settings.json，结果 90% 的新手卡在这一步。

一、发现问题：为什么新手总是配不好？

官方教程写的：

创建 ~/.deepcode/settings.json 文件

新手的反应：

• ~ 是什么？键盘上哪个键？
• 这路径在哪？我的 C 盘里怎么找不到？
• 终端是什么？怎么打开？

结果： 教程第一步就劝退。

二、分析问题：~ 到底是个啥？

一句话总结：~ 是苹果/ Linux 的"黑话"，Windows 要说 %USERPROFILE%。

三、解决问题：Windows 11 完整操作步骤

步骤 1：打开终端（3 种方式）

步骤 2：认识两个基础命令

cd %USERPROFILE%        ← 进入你的用户主文件夹（C:\Users\你的用户名）cd .deepcode            ← 进入 .deepcode 文件夹（前面配置已创建，这里直接进入）cd ..                   ← 返回上一级文件夹

步骤 3：创建文件夹和文件

手动方式（推荐新手）：

1. 文件资源管理器地址栏输入 %USERPROFILE% 回车
2. 右键 → 新建 → 文件夹 → 命名为 .deepcode（注意前面的点）
3. 进入文件夹 → 右键 → 新建 → 文本文档 → 改名为 settings.json

命令行方式（进阶）：

:: 先检查文件夹是否存在，不存在再创建（避免报错）if not exist %USERPROFILE%\.deepcode mkdir %USERPROFILE%\.deepcode:: 用记事本打开配置文件（不存在会自动新建）notepad %USERPROFILE%\.deepcode\settings.json

步骤 4：粘贴配置内容

{"env": {"MODEL": "deepseek-v4-pro","BASE_URL": "https://api.deepseek.com","API_KEY": "sk-你的真实API密钥"  },"thinkingEnabled": true,"reasoningEffort": "max"}

⚠️ 注意：BASE_URL 末尾不要留空格！

四、验证问题：怎么确认配对了？

打开终端，依次执行：

cd %USERPROFILE%\.deepcodetype settings.json

看到内容输出 = 配置成功 ✅

五、总结问题：核心就记三点

一句话版：Windows 里没有 ~，只有 C:\Users\你的用户名，配置 Deep Code 就是把 settings.json 放进这个目录下的 .deepcode 文件夹。

附：速查卡片（建议保存）

Linux/macOS          Windows 11─────────────────────────────────────~                    %USERPROFILE%~/.deepcode          %USERPROFILE%\.deepcodecd ~                 cd %USERPROFILE%mkdir -p ~/.deepcode  mkdir %USERPROFILE%\.deepcode