Coze Studio 开发环境完整指南Go 后端与 React 前端双栈调试的实操方法【免费下载链接】coze-studioAn AI agent development platform with all-in-one visual tools, simplifying agent creation, debugging, and deployment like never before. Coze your way to AI Agent creation.项目地址: https://gitcode.com/GitHub_Trending/co/coze-studioCoze Studio 是开源的一站式 AI Agent 开发平台提供智能体、工作流、知识库的搭建、调试与部署工具。后端为 Go HertzDDD 分层架构前端是 React 18 TypeScript monorepo由 Rush 管理 135 个包MySQL、Elasticsearch 等中间件经 Docker 管理。本文按克隆 → 启动 → 双栈调试的实际流程拆解配置中的关键决策。第一次调试闭环克隆与启动服务拿到仓库后最直接的疑问是先跑起来还是先装依赖两条路径对应两种角色。如果只是体验或部署在仓库根目录执行git clone https://gitcode.com/GitHub_Trending/co/coze-studio cd coze-studio make webmake web走 docker/docker-compose.yml 拉起全套服务前端 后端 中间件。首次拉取和构建镜像较慢看到Container coze-server Started即启动成功。随后访问http://localhost:8888/sign注册账号再到/admin/#model-management配置至少一个模型服务模型元数据模板位于 backend/conf/model/平台才能正常搭建智能体。如果是改代码开发用 Makefile 里的make debug目标它等价于env → middleware → python → server四步串联生成环境变量文件、用 docker/docker-compose-debug.yml 启动 MySQL / Redis / Elasticsearch / Milvus / MinIO / etcd / NSQ 等中间件、准备工作流代码节点需要的 Python 环境最后构建并运行 Go 服务。后端日志会直接打在终端里配合前端的开发服务器就能进入完整的调试循环。VS Code 一开仓库就卡Rush monorepo 的搜索与文件监听治理很多开发者遇到的第一个性能问题是文件搜索慢、CPU 占用高、保存文件后大量误报。原因不难猜——前端 monorepo 里每个包各有一份node_modules加上根目录的.rush、common/temp和几 MB 的pnpm-lock.yaml编辑器默认会把它们全部纳入搜索索引和文件监听。这个项目对此的解法是自带的模板配置 .vscode/settings.template.json并且不需要你手动复制scripts/hooks/post-rush-install.sh 作为 Rush 的postRushInstall钩子会在rush update后自动把模板落成.vscode/settings.json已有则跳过。值得注意的几个点search.exclude与files.exclude排除了node_modules、.rush、common/temp、**/dist等目录files.watcherExclude进一步把.git和node_modules从文件监听中移除这是性能问题的主要来源pnpm-lock.yaml被关联为plaintext而不是 YAML——模板里的注释写得很直白按 YAML 解析会让 VS Code 卡死cSpell.diagnosticLevel设为Warning拼写检查只做提示不报错避免在大型仓库里产生红色波浪线的噪音。插件方面.vscode/extensions.json 声明了推荐项Prettier、EditorConfig、Stylelint、Code Spell Checker 等同时用unwantedRecommendations显式禁用了两个 auto-import 插件——monorepo 的模块解析由 workspace 机制统一管理自动补全导入插件经常生成错误路径属于已知冲突点。Go 后端搞懂自动格式化 → 构建 → 启动这条链后端目录按 DDD 组织api/是 HTTP 路由与 handlerapplication/是用例编排domain/放业务实体与领域服务infra/实现存储、消息等基础设施跨域调用集中在crossdomain/。理解这条分层后改一个接口时能较快定位该动哪一层。开发环节的关键在 scripts/setup/server.shmake server并不是简单地go build它先对backend/全量执行goimports -w -local github.com/coze-dev/coze-studio把项目自身包名单独归组排序且自动跳过 mock、dal 等生成目录再把conf/与static/拷入bin/resources/最后产出bin/opencoze二进制。这意味着两件事一是你本地装好goimports后格式化完全交给构建脚本无需手动跑 gofmt二是构建失败会直接中断启动日志里的Go build failed对应 Go 编译错误先看编译输出再猜运行时问题。日常验证后端改动用仓库自带测试即可cd backend go test ./...另一个容易忽略的前置条件任何涉及智能体运行的功能都依赖模型配置构建脚本只会拷贝 backend/conf/model/ 下的模板API Key 与模型名需要你在模板中填写或通过管理后台配置否则调试到运行环节才会暴露模型不可用。前端rush update、热重载 Dev Server 与 Lint 配置的落点前端最大的坑是依赖安装方式。根目录执行npm install是错的——Rush monorepo 统一用rush update安装全部包依赖这也正是上面 VS Code 配置钩子被触发的时机。依赖装好后开发服务器这样起cd frontend/apps/coze-studio npm run dev主应用基于 Rsbuild保存即热重载。只改了某个业务包时不必全量构建用rushx rebuild -o 包名单包重编即可构建体系细节见 frontend/README.md。Lint 链路对贡献者尤其重要ESLint、Prettier、Stylelint、TypeScript 的共享配置都收敛在 frontend/config/ 下的独立包如eslint-config、ts-config、stylelint-config而 VS Code 模板配置把eslint.nodePath、prettier.prettierPath、stylelint.stylelintPath分别指向这些包的node_modulestypescript.tsdk也指向 workspace 内的 TypeScript——保证编辑器与命令行 CI 用的是同一套规则不会出现本地绿、CI 红。模板还额外把tsserver内存上限提到 16 GB、关闭 tsserver 日志落盘都是针对 monorepo 体量的实际调优。如果改的是 API 字段却找不到先查 idl/前后端接口契约由 Thrift 文件定义前端 TS 类型经idl2ts工具链生成。接口对不上时改 IDL 再生成而不是手改类型。提交前钩子git commit 时项目会自动做什么这个仓库的提交不是写完即推common/git-hooks/pre-commit 在每次提交时按顺序执行四件事先用block-unresolved-conflict.sh拦截仍含冲突标记的文件再给暂存文件补 Apache 许可头add-license-header.sh然后rush lint-staged只对改动文件跑 Prettier/ESLint依赖由 Rush autoinstaller 自动安装无需全局预装最后check-file-size.sh阻止过大文件入库。实操上有两个直接价值提交被拒时错误信息本身就告诉你卡在格式、许可头还是冲突残留按提示修完重新git add即可紧急情况下可用环境变量PRE_LINT1跳过 lint 环节。想全量自检时用rush lint与rush test前者覆盖全部包的静态检查后者跑 Vitest 单测。五分钟自检清单确认开发环境真正可用配置是否到位靠跑不靠猜。按下面五步各过一遍全部通过即可放心开始开发make debug执行到 Starting Go service浏览器能打开http://localhost:8888/并登录在backend/任意包跑go test ./...能正常通过无环境报错rush build全量构建无错误且 VS Code 搜索不再扫描node_modules修改 frontend/apps/coze-studio/ 下任一文件dev server 热重载生效编辑器内 ESLint 无异常报错故意在一个文件中留一处格式错误后git commit确认钩子能拦截并自动修复——这一步同时验证了 pre-commit 链路和 Prettier 集成。第五步是最容易被跳过、也最暴露问题的它能一次性确认钩子安装、lint 规则加载和编辑器配置三者都工作正常。全部通过后这套环境就具备了长期使用的稳定性。【免费下载链接】coze-studioAn AI agent development platform with all-in-one visual tools, simplifying agent creation, debugging, and deployment like never before. Coze your way to AI Agent creation.项目地址: https://gitcode.com/GitHub_Trending/co/coze-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考