第2章 开发环境与工具链
2.1 环境搭建：把“工作台”搭起来
就像做饭需要先准备厨房和厨具，开发COZE工作流前，我们得先搭好“工作台”——配置开发环境。这一步不难，跟着做就能搞定。
2.1.1 账号准备：先拿到“入场券”
第一步：注册COZE账号
1.打开浏览器，访问COZE官网（www.coze.cn），点击右上角“注册”；
2.选择“企业开发者”身份（个人学习选“个人开发者”也可以）；
3.填写手机号、验证码，设置密码，完成注册。
第二步：申请开发者权限
1.登录后，点击右上角头像→“开发者中心”；
2.找到“工作流开发权限”，点击“申请开通”；
3.填写简单信息（如公司名称、用途），提交后通常5分钟内会自动通过。
为什么需要开发者权限？
普通用户只能使用现成的工作流模板，开发者权限才能让你创建自定义流程、使用高级节点（如API调用、自定义连接器）。
2.1.2 本地环境配置：在自己电脑上开发
如果你习惯在本地写代码、调试，需要安装两个核心工具：COZE CLI（命令行工具）和Node.js（运行环境）。
Windows系统为例：
安装Node.js（COZE CLI依赖它运行）
1.访问Node.js官网，下载LTS版本（长期支持版，比如v20.x）；
2.双击安装包，一路“下一步”（默认会勾选“Add to PATH”，务必保留！）；
3.验证是否安装成功：按Win+R输入cmd打开命令提示符，输入node -v，如果显示版本号（如v20.10.0）就OK了。
安装COZE CLI
2.在命令提示符中输入：
bash
npm install -g coze-cli
3.验证安装：输入coze -v，显示版本号（如1.5.0）说明成功。
macOS/Linux系统：
安装Node.js推荐用nvm（版本管理工具）：
bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts

安装COZE CLI同样用npm install -g coze-cli。
避坑指南：
如果安装时提示“权限不足”（Linux/macOS），在命令前加sudo（如sudo npm install -g coze-cli）；
Windows用户如果报错“npm不是内部命令”，检查Node.js安装时是否勾选了“Add to PATH”，没勾选就重新安装。
2.1.3 云开发环境：直接在浏览器里开发
如果你不想在本地装软件，或者需要临时在别人电脑上开发，可以用COZE的Web IDE（在线集成开发环境）：
1.登录COZE后，进入“工作流开发”→“新建项目”；
2.系统会自动打开Web IDE，界面和本地编辑器类似，支持拖拽节点、写代码、实时预览。
Web IDE的好处：
无需配置环境，打开浏览器就能用；
自动保存代码，不怕电脑死机丢失进度；
内置调试工具，直接在网页上测试流程。
2.2 核心工具详解：你的“神兵利器”
开发工作流就像盖房子，需要锤子、螺丝刀等工具。COZE提供了3类核心工具，让你从设计到部署全流程顺畅。
2.2.1 COZE Studio：可视化“画”流程
作用：用拖拽的方式设计工作流，像“画流程图”一样简单。
界面组成（见下图示意）：
┌─────────────────────────────────────┐
│ 工具栏（保存/测试/部署） │
├─────────────┬─────────────┬─────────┤
│ 节点库 │ 画布区 │ 属性面板│
│ （触发器/ │ （拖拽节点 │ （配置 │
│ 操作/逻辑） │ 连线） │ 节点参数）│
└─────────────┴─────────────┴─────────┘
关键功能举例：
节点库：左侧列出所有可用节点（触发器、操作、逻辑等），鼠标拖到画布就能用；
画布区：中间空白区域，用鼠标连线连接节点，形成流程（比如“定时触发器”→“发送邮件节点”）；
属性面板：选中节点后，右侧显示配置项（如定时触发器的“执行时间”、邮件节点的“收件人地址”）。
小技巧：按住Ctrl键拖动节点，可以快速复制一个相同配置的节点。
2.2.2 COZE CLI：命令行“指挥”流程
作用：通过命令行操作工作流（创建项目、本地调试、部署上线），适合习惯代码的开发者。
常用命令速查表：

实战演示：创建并运行一个本地项目
1.打开命令提示符，输入：
bash
coze init hello-coze # 创建名为hello-coze的项目
cd hello-coze # 进入项目文件夹
code . # 用VS Code打开（如果安装了VS Code）

2.项目文件夹里会生成基础文件（workflow.json是流程配置，nodes/放自定义节点代码）；
3.输入coze dev启动调试，浏览器会自动打开本地预览页面，修改代码后实时生效。
2.2.3 第三方工具集成：让工具“协同作战”
单独用COZE Studio或CLI可能不够，搭配这些工具效率翻倍：

1. VS Code + COZE插件
   安装插件：在VS Code的“扩展”里搜索“COZE Workflow”，点击安装；
   功能：语法高亮（让workflow.json配置文件更易读）、代码片段（输入coze-trigger自动补全触发器代码）、一键部署（右键菜单直接执行coze deploy）。
2. Postman：调试API节点
   场景：当工作流需要调用外部API（如微信支付接口），先用Postman测试API是否能正常返回数据；
   示例：测试“查询天气API”时，在Postman里填好URL、参数，确认返回格式正确后，再把参数复制到COZE的“API调用节点”。
3. Git：版本管理
   作用：保存工作流代码的历史版本，不小心改乱了可以回滚；
   基础操作：
   bash
   git init # 初始化仓库
   git add workflow.json # 跟踪配置文件
   git commit -m "完成定时触发节点配置" # 提交修改
   
   2.3 第一个工作流：Hello World（动手实操）
   学编程的第一步是“Hello World”，学工作流也一样。我们来做一个每天早上9点自动输出“Hello, COZE Workflow!” 的简单流程，全程只需3步。
   步骤1：创建项目（用COZE Studio可视化方式）
   1.登录COZE，进入“工作流开发”→点击“新建项目”→输入名称“hello-world”，选择“空白流程”；
   2.系统自动打开COZE Studio画布。
   步骤2：添加节点（搭流程骨架）
   添加触发器：
   o从左侧节点库找到“定时触发器”，拖到画布；
   o在右侧属性面板设置：
   执行周期：“每天”
   执行时间：“09:00”
   时区：“Asia/Shanghai”（北京时间）
   添加日志输出节点：
   o从节点库拖一个“日志输出”节点到画布，放在触发器右侧；
   o用鼠标点击触发器的“→”图标，连线到日志节点（表示“触发器触发后执行日志节点”）；
   o在日志节点的属性面板填写“输出内容”：Hello, COZE Workflow!
   步骤3：测试与运行
   本地测试：
   o点击画布上方的“测试”按钮，选择“触发一次”；
   o下方会显示执行日志，看到[INFO] Hello, COZE Workflow!说明测试成功。
   部署上线：
   o点击“部署”按钮，选择“生产环境”，确认部署；
   o部署成功后，系统会显示“流程已上线”，并给出流程ID（如wf_789）。
   查看效果：
   o第二天早上9点后，在COZE控制台→“我的流程”→找到“hello-world”→点击“日志”，就能看到自动执行的记录。
   本章小结
   开发环境和工具就像厨师的“灶台”和“锅铲”，熟悉它们是做出“好菜”的前提。本章你学会了：
   用COZE Studio可视化设计流程；
   用COZE CLI命令行操作项目；
   搭配VS Code、Postman、Git提升效率；
   亲手完成了第一个自动执行的工作流。

来站原创，转载请注明出处：https://www.xin3721.com/ArticlePrograme/robot/52944.html