本地包与功能模块
将功能提取到本地 Swift 包中，以加快构建并实现隔离。
本地包与功能模块 是 CoddyKit 上的免费 Swift Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。
为什么使用功能模块
将应用拆分为本地包可以强制执行封装、加快增量构建，并支持团队并行开发。
// Without modules: one giant target recompiles everything
// With modules: changes to FeatureA only recompile FeatureA创建本地包
在 Xcode 项目旁创建一个目录，并在其中运行 swift package init。
mkdir Features/UserProfile
cd Features/UserProfile
swift package init --name UserProfile --type library添加到 Xcode 项目
将本地包目录拖入 Xcode 的项目导航器。Xcode 会自动将其识别为 SPM 包。
// In Xcode:
// File → Add Package Dependencies → Add Local...
// Select the package directory引用本地包
在应用的 Package.swift 中（或通过 Xcode）使用 .package(path:) 引用本地包。
.package(path: "../Features/UserProfile"),
// In the target:
.product(name: "UserProfile", package: "UserProfile")公共 API 表面
应用只能访问本地包中声明为 public 和 open 的内容。使用访问控制定义模块边界。
// UserProfile/Sources/UserProfile/ProfileView.swift
public struct ProfileView: View {
public init() {}
public var body: some View { Text("Profile") }
}内部实现
所有 internal 类型在模块外部都不可见，从而自动实现封装。
// Only visible within UserProfile module:
final class ProfileCache { ... }
struct ProfileMapper { ... }功能模块结构
每个功能模块在内部拥有自己的领域层、数据层和表现层。
// UserProfile/
// ├── Sources/UserProfile/
// │ ├── Domain/ (entities, use cases, protocols)
// │ ├── Data/ (repositories)
// │ └── Presentation/ (views, view models)
// └── Tests/UserProfileTests/共享核心模块
将横切关注点（网络、分析、设计系统）提取到共享模块中，由功能模块导入。
// CoreNetwork package
// CoreDesign package
// Both imported by FeatureA and FeatureB依赖图
功能模块不应直接依赖彼此。共享依赖应通过核心模块传递，以避免耦合。
// GOOD:
// FeatureA → CoreNetwork
// FeatureB → CoreNetwork
// BAD:
// FeatureA → FeatureB (tight coupling)构建时间优势
有了清晰的模块边界，当源文件发生变化时，Xcode 只会重新构建受影响的模块。
// Change in UserProfile → only UserProfile recompiles
// App target links the new binary → fast incremental build测试功能模块
每个功能模块都有自己的测试目标，从而支持并行执行测试并加快持续集成。
// Run all tests:
swift test --package-path Features/UserProfile
// Or let Xcode run them as part of the main test plan快速检查
本地 Swift 包中的声明需要具有什么访问级别，应用目标才能使用？
课程回顾
使用 swift package init 创建本地功能包，通过 .package(path:) 引用它们，并且只公开 public 类型。将共享工具提取到核心模块中。功能模块不应相互依赖。清晰的模块边界可以大幅缩短增量构建时间。
常见问题解答
「本地包与功能模块」课时是免费的吗？
是的 — 「本地包与功能模块」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。
「本地包与功能模块」这节课中我会学到什么？
将功能提取到本地 Swift 包中，以加快构建并实现隔离。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Swift Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「本地包与功能模块」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Swift Academy 课中编写并运行代码吗？
能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。