Update 2025-12-16-smth.md

Author: bitnpc

_posts/2025-12-16-smth.md

@@ -101,7 +101,8 @@ graph TB
 
 以 `TopicListViewModel` 为例，展示 MVVM 的核心实现：
 
-```swift:12:93:App/Modules/Home/ViewModels/TopicListViewModel.swift
+```swift
+// App/Modules/Home/ViewModels/TopicListViewModel.swift
 @MainActor
 final class TopicListViewModel: ObservableObject {
     @Published private(set) var topics: [Topic] = []
@@ -158,7 +159,8 @@ Repository 层抽象了数据访问逻辑，提供统一的接口。这种设计
 - **可维护性**：数据源变更（如从 API 切换到本地数据库）只需修改 Repository 实现
 - **单一职责**：Repository 只负责数据获取，不涉及业务逻辑
 
-```swift:22:66:App/Core/Networking/Repositories/TopicRepository.swift
+```swift
+// App/Core/Networking/Repositories/TopicRepository.swift
 struct TopicRepository: TopicRepositoryProtocol {
     private let apiService: APIService
 
@@ -174,7 +176,8 @@ struct TopicRepository: TopicRepositoryProtocol {
 
 项目使用自定义的依赖注入容器 `AppContainer`，统一管理所有依赖项：
 
-```swift:16:50:App/Core/Dependency/AppContainer.swift
+```swift
+// App/Core/Dependency/AppContainer.swift
 final class AppContainer: DependencyContainer {
     static let shared = AppContainer()
 
@@ -200,7 +203,8 @@ final class AppContainer: DependencyContainer {
 
 项目实现了通用的分页状态管理类 `PaginationState`，用于统一管理列表的分页逻辑：
 
-```swift:11:38:App/Core/Pagination/PaginationState.swift
+```swift
+// App/Core/Pagination/PaginationState.swift
 struct PaginationState<Item: Identifiable & Hashable> {
     private(set) var items: [Item] = []
     private(set) var currentPage: Int = 0
@@ -278,7 +282,8 @@ SwiftUI 作为 Apple 的现代 UI 框架，采用声明式编程范式，让 UI
 
 SwiftUI 的核心思想是通过描述 UI 的"状态"而非"步骤"来构建界面。这种声明式的方式让代码更加直观：
 
-```swift:33:68:App/Modules/Home/HomeView.swift
+```swift
+// App/Modules/Home/HomeView.swift
 var body: some View {
     ScrollView {
         LazyVStack(spacing: AppTheme.compactSpacing) {
@@ -315,7 +320,8 @@ SwiftUI 提供了多种状态管理方式，选择合适的属性包装器很重
 
 **最佳实践：**
 
-```swift:11:21:App/Modules/Home/HomeView.swift
+```swift
+// App/Modules/Home/HomeView.swift
 struct HomeView: View {
     @EnvironmentObject private var browsingHistory: BrowsingHistoryStore
     @Environment(\.colorScheme) private var colorScheme
@@ -332,7 +338,8 @@ struct HomeView: View {
 
 通过 ViewModifier 实现可复用的样式，保持 UI 一致性：
 
-```swift:74:117:App/Core/Utils/AppTheme.swift
+```swift
+// App/Core/Utils/AppTheme.swift
 extension View {
     func smthScaffoldBackground() -> some View {
         modifier(ScaffoldBackgroundModifier())
@@ -400,7 +407,8 @@ var body: some View {
 
 在 SwiftUI 中处理异步操作时，使用 `Task` 和 `async/await`：
 
-```swift:81:95:App/Modules/Home/HomeView.swift
+```swift
+// App/Modules/Home/HomeView.swift
 .onAppear {
     Task {
         await navigationViewModel.loadNavigationsIfNeeded()
@@ -418,7 +426,8 @@ var body: some View {
 
 SwiftUI 支持使用 `#if os()` 进行平台特定代码：
 
-```swift:19:36:App/Components/ImageViewer.swift
+```swift
+// App/Components/ImageViewer.swift
 var body: some View {
     #if os(iOS)
     ImageViewerUIKit(images: images, initialIndex: initialIndex, isPresented: $isPresented)
@@ -432,7 +441,8 @@ var body: some View {
 
 项目将 UI 拆分为可复用组件，每个组件职责单一：
 
-```swift:44:134:App/Modules/Home/TopicRowView.swift
+```swift
+// App/Modules/Home/TopicRowView.swift
 struct TopicRowView: View {
     let topic: Topic
     let isVisited: Bool
@@ -477,7 +487,8 @@ struct TopicRowView: View {
 
 项目在 `ContentView` 中根据平台选择不同的导航方式：
 
-```swift:28:42:App/ContentView.swift
+```swift
+// App/ContentView.swift
 var body: some View {
     Group {
         #if os(macOS)
@@ -495,7 +506,8 @@ var body: some View {
 
 **iOS 实现（TabView）：**
 
-```swift:44:78:App/ContentView.swift
+```swift
+// App/ContentView.swift
 private var tabLayout: some View {
     TabView(selection: $selection) {
         NavigationStack {
@@ -509,7 +521,8 @@ private var tabLayout: some View {
 
 **macOS 实现（NavigationSplitView）：**
 
-```swift:117:145:App/ContentView.swift
+```swift
+// App/ContentView.swift
 #if os(macOS)
 private var macSidebarLayout: some View {
     NavigationSplitView(columnVisibility: $columnVisibility) {
@@ -535,7 +548,8 @@ private var macSidebarLayout: some View {
 
 **iOS（UIKit 实现）：**
 
-```swift:39:62:App/Components/ImageViewer.swift
+```swift
+// App/Components/ImageViewer.swift
 #if os(iOS)
 private struct ImageViewerUIKit: UIViewControllerRepresentable {
     func makeUIViewController(context: Context) -> ImagePageViewController {
@@ -547,7 +561,8 @@ private struct ImageViewerUIKit: UIViewControllerRepresentable {
 
 **macOS（SwiftUI 实现）：**
 
-```swift:64:215:App/Components/ImageViewer.swift
+```swift
+// App/Components/ImageViewer.swift
 #if !os(iOS)
 private struct ImageViewerSwiftUI: View {
     @State private var currentIndex: Int
@@ -573,7 +588,8 @@ private struct ImageViewerSwiftUI: View {
 
 **iOS（底部弹出）：**
 
-```swift:134:141:App/Modules/Home/HomeView.swift
+```swift
+// App/Modules/Home/HomeView.swift
 #if os(iOS)
 .sheet(isPresented: $showProfileView) {
     ProfileView()
@@ -584,7 +600,8 @@ private struct ImageViewerSwiftUI: View {
 
 **macOS（独立窗口）：**
 
-```swift:142:149:App/Modules/Home/HomeView.swift
+```swift
+// App/Modules/Home/HomeView.swift
 #elseif os(macOS)
 .sheet(isPresented: $showProfileView) {
     ProfileView()
@@ -626,7 +643,7 @@ graph LR
 
 项目使用 SwiftLint 进行代码规范检查，配置文件为 `swiftlint.yml`：
 
-```yaml:1:45:swiftlint.yml
+```yaml
 disabled_rules:
   - identifier_name
   - trailing_whitespace
@@ -666,7 +683,7 @@ swiftlint --fix --config swiftlint.yml  # 自动修复
 
 **Fastlane 集成：**
 
-```ruby:70:80:fastlane/Fastfile
+```ruby
 lane :lint do
   sh("swiftlint --config swiftlint.yml")
 end
@@ -678,7 +695,7 @@ end
 
 项目使用 GitHub Actions 实现持续集成：
 
-```yaml:1:58:.github/workflows/ci.yml
+```yaml
 name: CI
 
 on:
@@ -731,7 +748,7 @@ graph TB
 
 Fastlane 的 `ci` lane 整合了代码检查和测试：
 
-```ruby:147:152:fastlane/Fastfile
+```ruby
 lane :ci do
   lint
   tests
@@ -751,7 +768,8 @@ end
 
 **ViewModel 测试示例：**
 
-```swift:1:60:SmthTests/TopicListViewModelTests.swift
+```swift
+// SmthTests/TopicListViewModelTests.swift
 final class TopicListViewModelTests: XCTestCase {
     func testInitialLoadFetchesTopics() async throws {
         let repository = StubTopicRepository(