第1章 环境准备与 Qoder CN 注册安装

本章目标：注册 Qoder CN 账号、安装 Qoder CN IDE、备齐本地开发环境（JDK、Maven、MySQL、Node.js、Git），并创建本教程的工作区目录。全部就绪后，你就拥有一个可以开始 VibeCoding 的战场。

学习目标

1. 能注册并登录 Qoder CN，理解 Credits 额度概念
2. 能安装 Qoder CN IDE 并熟悉界面（对话区、Agent、设置）
3. 能在本地装好 JDK 17、Maven、MySQL 8、Node.js、Git 并验证版本
4. 能创建本教程工作区目录 mini-wms-workspace

1.1 注册 Qoder CN 账号

Qoder CN（原名"智能编码助手通义灵码"，2026 年 5 月更名）是阿里巴巴推出的 AI 编程产品，支持用手机号或阿里云账号登录。个人基础版免费，Pro/Pro+ 为付费订阅，用量以 Credits（额度） 计量。

操作步骤

1. 浏览器打开官网：https://qoder.cn （或 https://qoder.com.cn）
2. 点击右上角「登录 / 注册」
3. 选择手机号验证码登录：输入手机号 → 收取验证码 → 完成注册（系统会自动为你创建关联账号）
   • 若你已有阿里云账号，也可选「阿里云账号登录」，账号与订阅可互通
4. 注册成功后，进入控制台可看到自己的 Credits 用量情况

注意事项

• ⚠️ 请记录你注册用的手机号，后续 IDE 登录、额度查询都依赖它。
• ⚠️ 免费额度适合学习和小项目练习；本教程的 WMS 属于中等规模，全程 Agent 对话会消耗一定 Credits，建议留意剩余额度。具体计费以官网「计费说明」为准。
• 💡 首次使用可能会有新用户试用额度（如 Pro 试用 + Credits 赠送），以官网当期活动为准。

1.2 安装 Qoder CN IDE

Qoder CN 有多种使用形态：独立 IDE 客户端、JetBrains 插件、VS Code 插件、命令行 CLI。本教程统一使用 Qoder CN IDE（独立客户端），因为它开箱即用、无需额外装插件，且 Agent / Repo Wiki / 记忆等能力集成最完整。

操作步骤

1. 进入下载页：https://qoder.cn/download
2. 根据你的操作系统选择安装包（本教程以 Windows 10/11 x64 为例）
   • Windows 有两种包：User 版（装到当前用户目录、无需管理员权限）和 System 版（装到 C:\Program Files、需管理员权限）。功能完全一致。个人电脑或公司电脑没有管理员密码，选 User 版即可。
3. 双击安装包，按向导一路「下一步」完成安装
4. 启动 Qoder CN IDE，首次启动会让你选择界面主题
5. 点击右上角用户图标（或快捷键 Ctrl+Shift+,）→「登录」→ 选择「阿里云中国站账号登录 / 手机号登录」，浏览器会打开登录页，完成后回到 IDE

预期结果

• IDE 左下角或右上角显示你已登录的账号
• 能打开左侧「Qoder / Chat」对话面板

注意事项

• ⚠️ 登录会在浏览器完成跳转，如果公司网络拦截了 qoder.com 回调页，可换用手机热点完成首次登录。
• 💡 Qoder CN IDE 基于 VS Code 开源体系构建，操作习惯与 VS Code 基本一致；熟悉 VS Code 的同学几乎零学习成本。

1.3 安装本地开发环境

WMS 项目需要以下工具。请逐个安装并用命令验证。已装过的可跳过版本检查即可。

工具	版本要求	验证命令
JDK	17 及以上	java -version
Maven	3.8+（可用 IDE 内置）	mvn -version
MySQL	8.0+	mysql --version
Node.js	18 LTS 及以上	node -v
Git	任意较新版本	git --version

操作步骤

1）安装 JDK 17

• 推荐下载 Adoptium Temurin JDK 17 或你已有的 JDK 25 均可（Spring Boot 3 要求 ≥17）。
• 安装后配置环境变量 JAVA_HOME 指向 JDK 目录，Path 中加入 %JAVA_HOME%\bin。
• 打开新的终端（PowerShell）执行：

java -version

看到类似 openjdk version "17.x" 即成功。

2）安装 Maven

• 下载 Apache Maven 二进制包，解压后配置 MAVEN_HOME 与 Path。
• （可选但推荐）配置阿里云镜像加速依赖下载：编辑 Maven conf/settings.xml，在 <mirrors> 中加入：

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

• 验证：

mvn -version

💡 Qoder CN IDE 内置了 Maven 支持，第4章创建工程时也可让它用项目自带的 Maven Wrapper（mvnw），这样甚至不需要本机装 Maven。但本机装一个更稳妥。

3）安装 MySQL 8

• 安装 MySQL 8 Community Server，记住你设置的 root 密码。
• 安装完成后，用客户端（如 Navicat / MySQL Workbench / 命令行）验证能连上：

mysql -uroot -p

⚠️ 本教程第3章会让 Qoder 生成建表 SQL，届时用图形工具或命令行执行即可。如果你在本机装 MySQL 有困难，也可以让 Qoder 帮你用 Docker 起一个 MySQL（第9章会讲 Docker）。

4）安装 Node.js

• 下载 Node.js 18 或 20 LTS 安装包，一路默认安装（会自动装好 npm）。
• 验证：

node -v
npm -v

• （可选）配置淘宝镜像加速前端依赖：

npm config set registry https://registry.npmmirror.com

5）安装 Git

• 下载 Git for Windows，默认安装即可。
• 配置用户名邮箱（用于提交记录）：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

注意事项

• ⚠️ 每装完一个工具，请新开一个终端窗口再验证，否则环境变量可能还没生效。
• ⚠️ Node.js 版本过低会导致前端脚手架（Vite）报错，务必用 18 及以上。

1.4 创建工作区目录

我们把所有代码放在一个统一的工作区目录下，方便 Qoder 索引整个项目、也方便你在第4章让 Qoder 直接在此目录生成工程。

操作步骤

1. 在 D 盘（或你常用的盘）新建目录，例如 D:\mini-wms-workspace
2. 在 Qoder CN IDE 中：「文件 → 打开文件夹」，选择该目录
3. 打开后，Qoder 会开始索引工作区（右下角或底部会有进度提示）

预期结果

• 左侧资源管理器能看到该空目录
• Qoder 对话面板可正常输入

1.5 认识 Qoder CN 的三个核心能力（先会用第2章就开始用）

在正式开发前，花 5 分钟了解本教程会反复用到的三个能力：

1. Agent（智能体）模式：能自主读写文件、执行命令、多步骤完成一个任务。你说"帮我创建一个 Spring Boot 工程"，它会真的去建文件、写代码、跑命令。第4~9章主要用它。
2. Chat / Plan（对话与规划）：偏"讨论与产出文档"，适合需求分析、方案设计。第2~3章主要用它，让它帮你把想法整理成 PRD 和设计文档。
3. 记忆（Memory）与 Rules（规则）：Qoder 会记住项目约定（如包名、技术栈），你也可以写项目级规则约束它的产出风格。第4章我们会配置一份项目规则，让后续每次生成都遵守统一规范。

💡 提示：对话时把上下文"喂"够——涉及已有文件时，用 # 引用文件/代码片段（不同版本快捷键可能略有差异，可在输入框试试 # 或 @ 引用）。上下文越准，AI 产出越靠谱。

本章检查清单

• [ ] Qoder CN 账号已注册并能登录 IDE
• [ ] Qoder CN IDE 安装完成，能看到对话面板
• [ ] java -version 显示 17+
• [ ] mvn -version 正常（或计划用 Maven Wrapper）
• [ ] MySQL 8 可连接，记住 root 密码
• [ ] node -v 显示 18+
• [ ] git --version 正常，已配置用户名邮箱
• [ ] 工作区目录已创建并在 Qoder 中打开

全部打勾后，进入 第2章 需求分析。

常见问题

Q：一定要用独立 IDE 吗？我习惯 IntelliJ IDEA。 A：可以。你也可在 IDEA 里安装 Qoder CN JetBrains 插件，功能与本教程基本一致。但独立 IDE 的 Agent / Repo Wiki 集成最完整，推荐新手直接用独立 IDE。

Q：Credits 用完了怎么办？ A：可在官网查看用量并按需升级订阅；学习阶段可先规划好每次对话的目标，避免反复无效生成（这也是本教程强调"先想清楚再让 AI 动手"的原因）。

Q：MySQL 装不上 / 不想装。 A：可先跳过，等第4章让 Qoder 用 Docker 起一个 MySQL 容器；没有 Docker 的话再回到本机安装。