该技能用于指导 Scala 后端开发,强调直接风格(direct-style)编程、Ox 结构化并发以及工具链规范化使用。
用途与原则:以纯函数、不可变数据、ADT 和显式依赖为核心,禁止共享可变状态;类字段不得使用 var,状态用不可变 case class 加纯函数转换,副作用通过 trait 隔离以便测试。
工具链要求:使用工具而非 bash 编译和运行测试;新增依赖后运行 import-build;用 find-dep 查询依赖版本,不可从 search.maven.org/solrsearch 获取(索引可能滞后)。已知识别坐标可读 https://repo1.maven.org/maven2/<group-with-slashes>/<artifact>/maven-metadata.xml 取 release 或最后版本,注意 Scala 后缀(如 core_3);未知坐标先用 Scaladex 的 https://index.scala-lang.org/api/autocomplete?q=<name> 查找。API 用 inspect、文档用 get-docs/get-usages、编译用 compile-full/compile-module、符号搜索用 glob-search/typed-glob-search;需要 sbt 时用 sbt --client,验证启动用 sbt run(不加 --client)。提交前执行 sbt --client scalafmtAll,项目须零警告,build.sbt 需含 -Wunused:all、-Wvalue-discard、-Wnonunit-statement。
direct-style 约束:Tapir 端点必须用 .handle/.handleSecurity/.handleSuccess,禁止 .serverLogic 系列;线程、通道与异步协调统一用 Ox,避免裸 Thread.ofVirtual、LinkedBlockingQueue、synchronized 等;并发前先确定作用域归属,不允许把持有运行中 fork 的对象返回出去。
性能与数据:禁止把无界数据整体载入内存,使用 Flow 或分页流式处理;长 CPU 密集计算用 computeIntensive,必要时每秒调用一次 cede()。
使用方式:编码前须按任务从指南拉取相关章节原文并完整阅读,遵守其中必需 API,不用摘要工具,以免遗漏 Required/Important 提示。
限制:资料未提供官方收费、价格、平台兼容范围或效果评估等信息。