XCode 实战:Todo REST API

本章从打开终端到跑通一个完整的 Todo REST API,全程由 XCode + DeepSeek V4 驱动。

XCode + DeepSeek V4 配置参考:XCode DeepSeek 配置

先来看下 XCode 的基本操作界面和日常高频命令。

---

启动你的第一个 XCode 会话

打开终端,进入任意一个工作目录(或新建一个空文件夹),然后输入:

$ mkdir runoob-todo-api
$ cd runoob-todo-api
$ xcode

首次启动会看到欢迎界面和版本信息以及 DeepSeek 的环境变量配置。

> 如果不确定配置是否生效,进入后立刻输入 /status,确认 Base URL 指向的是 https://api.deepseek.com/xmingtec。

---

常用斜杠命令速查表

在 XCode 的对话框中,以 / 开头的是内置命令,不会发送给模型。

| 命令 | 作用 | |------|------| | /status | 查看当前模型、Base URL、会话统计 | | /help | 显示所有可用命令 | | /clear | 清除当前对话上下文(不删除文件) | | /exit 或 Ctrl+C | 退出 XCode | | /undo | 撤销上一次文件修改 | | /diff | 查看最近一次修改的 git diff |

---

权限提示机制

当 XCode 准备写入文件、执行命令时,它会先暂停,列出将要做的操作,等待你确认。

这是 XCode 最重要的安全机制,初学者不必担心 AI 失控乱改。

你会看到类似这样的提示:

┌─────────────────────────────────────────────────┐
│  XCode wants to create the following files:     │
│                                                  │
│  • src/index.js                                  │
│  • src/routes/todos.js                           │
│  • package.json                                  │
│                                                  │
│  Allow? [Y/n]                                    │
└─────────────────────────────────────────────────┘

直接按 Enter 或输入 y 确认,输入 n 跳过。

---

实战项目:用 AI 从零搭一个 Todo API

本节带你用自然语言驱动 XCode,从零生成一个可运行的 Node.js REST API。

项目目标

我们要搭建一个具备以下功能的 REST API:

| 接口 | 功能 | |------|------| | GET /todos | 获取所有待办事项 | | POST /todos | 创建新待办事项 | | PUT /todos/:id | 更新待办事项(标记完成/修改内容) | | DELETE /todos/:id | 删除待办事项 |

技术栈:Node.js + Express,数据暂存于内存(不需要数据库,降低复杂度)。

步骤 1:用自然语言描述需求

在 XCode 的对话框中输入以下内容(直接复制粘贴即可):

请帮我从零创建一个 Node.js + Express 的 Todo REST API 项目。

要求:

  • 支持 GET /todos、POST /todos、PUT /todos/:id、DELETE /todos/:id 四个接口
  • 数据先存在内存数组里,不需要数据库
  • 每个 todo 包含:id、title、completed(布尔值)、createdAt 字段
  • 请求和响应都使用 JSON 格式
  • 加上基础的错误处理(404、400 等)
  • 生成一份 README.md,说明如何启动和测试接口

项目结构建议: my-todo-api/ ├── src/ │ ├── index.js # 入口文件 │ └── routes/ │ └── todos.js # Todo 路由 ├── package.json └── README.md

> 写好提示词的三个要素:上下文(告诉 AI 技术栈和项目背景)、约束(明确你不想要什么)、期望输出(给出具体的文件结构或格式要求)。

步骤 2:XCode 生成文件结构

确认权限后,XCode 会依次创建以下文件。

生成过程中,有很多权限确认,一般直接选 Yes 就好了。

成功后,会有如下信息输出,包含生成的内容,启动信息等,非常详细。

查看下生成的项目结构。