如何快速上手 Polymarket-Copy-Trading-Bot:从零跑通 Play + Scala.js 全栈项目的完整步骤

原创2026-10-13 09:49:551,439 阅读

如何快速上手 Polymarket-Copy-Trading-Bot:从零跑通 Play + Scala.js 全栈项目的完整步骤

Polymarket-Copy-Trading-Bot 是一个基于 Play 框架 与 Scala.js 的全栈项目模板,采用"前后端同语言(Scala)"的架构:server 端负责 Web 服务,client 端在浏览器中运行,shared 模块让两端共享同一份 Scala 代码。本文带你从零开始,按完整步骤跑通这个 Play + Scala.js 全栈项目,最快 5 分钟即可在浏览器看到 "It works!" 页面输出。

📌 项目简介:Play + Scala.js 全栈架构长什么样?

这个项目通过 sbt-web-scalajs 插件 将 Play 与 Scala.js 深度集成,生成后的应用包含三大目录:

目录 角色 说明
server 服务端 Play 应用,提供路由、控制器与模板渲染
client 客户端 Scala.js 应用,编译为 JS 在浏览器中运行
shared 共享模块 服务端与客户端共用的 Scala 代码

一次典型的请求链路是:浏览器页面里的 ScalaJSExample.scala 调用共享消息 SharedMessages.scala,再由 Application.scala 控制器把同一句话渲染进首页——三端各司其职,这正是"全栈同语言"的价值所在。

📖 更多背景可阅读项目自带的 README.md。

🧰 环境准备:只需 2 个工具

开始之前,请确认电脑上已安装:

  • JDK 8+(Scala 与 sbt 的运行基础)
  • sbt(Scala 构建工具,负责编译 server 与 client 两侧代码)

验证是否安装成功:

$ java -version
$ sbt --version

⏱️ 提示:首次运行 sbt 会自动下载依赖,耗时较长属于正常现象,请耐心等待。

🚀 最快上手步骤:5 分钟跑通项目

第一步:克隆仓库

$ git clone https://gitcode.com/gh_mirrors/ev/polymarket-copy-trading-bot
$ cd polymarket-copy-trading-bot

第二步:启动 sbt 并切换到 server 子项目

根项目聚合了所有子项目(server、client、shared),进入后先切换到服务端:

$ sbt
sbt:root> project server

第三步:启动应用

[server] run

第四步:打开浏览器验证

访问 http://localhost:9000 ,看到页面上的 "It works!" 字样,说明 Play 服务端与 Scala.js 客户端已全部跑通 ✅。

💡 支持 ~run 连续编译模式:保存代码后自动重新构建,开发时非常方便。

⚙️ 核心特性:开发效率提升点

操作 触发的 Scala.js 任务 效果
compile fastLinkJS 快速增量编译前端代码
run fastLinkJS 每次刷新页面自动重新链接
~compile / ~run 连续编译 热更新,改完即生效

其他值得了解的特性:

  • 编译错误可视化:Scala.js 项目的编译错误会直接显示在浏览器中,不用来回翻控制台;
  • Source Maps 默认开启:打开浏览器开发者工具即可打断点、定位抛异常的代码行(fastLinkJS 与 fullLinkJS 均默认启用);
  • 生产打包一键切换:打包前把 scalaJSStage 设为 FullOptStage,即可执行 fullLinkJS 生成优化后的产物:
sbt 'set Global / scalaJSStage := FullOptStage' Universal/packageBin

部署时 Procfile 已定义好启动命令,application.conf 中配置了静态资源路径 /assets,配合 routes 中的资产路由即可完整服务前端文件。

🖥️ IDE 集成:IntelliJ 与 Eclipse 导入步骤

IntelliJ

  1. 打开 Project wizard,选择 Import Project,选中项目根目录;
  2. 选择 Import project from external model → SBT project;
  3. 点击 Next 并勾选附加导入选项,Finish 完成导入。

⚠️ 请确保使用 IntelliJ Scala 插件 v2017.2.7 或更高版本,旧版本存在已知兼容问题。

Eclipse

  1. 在 project/plugins.sbt 中加入 sbteclipse 插件(版本 5.2.4);
  2. 在 build.sbt 的 server 配置中加入 EclipseKeys.preTasks := Seq(Compile / compile),先生成 Twirl 模板的源文件;
  3. 运行 sbt "eclipse with-source=true";
  4. 在 Eclipse 中选择 File/Import/General/Existing project...,选中根目录,取消勾选第三个复选框(仅导入 client、server 和 shared/.jvm),点击 Finish:

Eclipse 导入 Polymarket-Copy-Trading-Bot 的 Play + Scala.js 全栈项目,展示 client、server、shared 三个子目录勾选状态

🧹 清理与进阶小技巧

  • 一键清理所有子项目:root 项目聚合了全部子项目,执行 sbt clean 即可统一清理;
  • 启动时自动加载 server 项目:在 build.sbt 中加入 Global / onLoad := (Global / onLoad).value.andThen(state => "project server" :: state),省掉每次手动切换;
  • 持续集成检查:仓库中的 ci/checksourcemaps.sh 演示了如何在 CI 中验证 Source Maps 是否按要求打包进产物,可作为你流水线脚本的参考。

❓ 常见问题排查

问题 可能原因 解决方法
首次 run 卡住不动 sbt 正在下载依赖 保持网络通畅,等待下载完成
页面刷新后前端改动不生效 未触发 fastLinkJS 确认使用了 run 而非手动启动 jar 包
IntelliJ 导入报错 Scala 插件版本过低 升级到 v2017.2.7+
Eclipse 中缺少模板文件 未先编译 server 添加 EclipseKeys.preTasks 后再重新生成

✅ 小结

按照本文的完整步骤,你已经完成了:克隆仓库 → 启动 sbt → 切换 server 子项目 → 打开浏览器看到 "It works!"。至此,Play + Scala.js 全栈项目已在本地跑通——接下来就可以把 shared 里的逻辑扩展为你的业务代码,让服务端与浏览器共享同一份 Scala 实现。祝开发顺利 🚀

登录后查看全文
polymarket-copy-trading-bot