Scala.js crossProject与手动配置：仅为便捷配置还是有关键作用？
你提到手动配置模块也能实现Scala.js和Scala JVM共用源码，但crossProject远不止是简化配置的语法糖——它解决了手动配置会遇到的诸多痛点，提供了跨平台项目的核心整合能力：
自动同步核心配置：手动配置两个独立模块时，你需要重复设置Scala版本、依赖库、编译选项等，稍有疏忽就会出现版本不一致的问题。
crossProject会自动同步这些核心配置到JVM和JS子项目，确保两者的构建环境完全一致。跨平台依赖的智能处理：很多库同时提供JVM和JS版本（比如
cats、circe），crossProject能自动识别并为对应平台引入正确的依赖变体，无需你手动区分%和%%%的使用场景，避免依赖错误。统一的任务执行入口：使用
crossProject后，你可以通过compile、test等根任务一次性编译或测试两个平台的代码，而手动配置需要分别执行jvm/compile、js/compile这类拆分任务，大大提升了开发效率。源码共享的规范支持：它默认遵循Scala跨平台项目的源码结构约定（比如
src/main/scala存放共享代码，src/main/scala-jvm/src/main/scala-js存放平台特定代码），手动配置虽然也能自定义结构，但需要额外编写大量配置来实现同样的源码逻辑隔离和共享，容易出错且维护成本高。与Scala生态工具的深度整合：比如sbt的
crossScalaVersions、IDE支持（IntelliJ、VS Code）等，crossProject能无缝对接这些工具，确保跨平台项目的开发体验流畅；手动配置的模块可能会出现IDE无法识别跨平台源码结构、任务同步失败等问题。
当然，如果你的项目极其简单，手动配置两个模块确实能勉强实现需求，但随着项目复杂度提升，crossProject带来的一致性、可维护性和效率提升会变得至关重要，这也是官方文档推荐它的核心原因。
内容的提问来源于stack exchange，提问作者Yaroslav
