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 就好了。
成功后,会有如下信息输出,包含生成的内容,启动信息等,非常详细。
查看下生成的项目结构。