烛衔溟-优快云博客

原创 HarmonyOS 网络连接 —— HTTP 请求、Axios 与 Socket 通信

摘要：本文为鸿蒙开发者系统讲解网络通信能力，重点涵盖HTTP请求、Axios集成、TCP Socket与WebSocket应用。首先介绍网络权限配置及安全注意事项，随后详细解析使用@ohos.net.http发起GET/POST请求、文件上传的实现方法。针对开发效率，演示如何集成@ohos/axios实现拦截器与统一错误处理。最后深入讲解基于@ohos.net.socket的TCP长连接和@ohos.net.webSocket的双向通信，帮助开发者构建高性能网络层。

2026-08-04 14:39:14 348

原创 HarmonyOS 组件导航 —— Navigation 架构与 NavDestination 生命周期

本文面向已掌握 HarmonyOS 基本路由机制的开发者，系统讲解 ArkUI Navigation 组件的进阶用法。核心内容包括：架构解析：Navigation 通过 NavPathStack 显式管理页面栈，配合 NavDestination 实现模块化导航，支持灵活转场动画与跨模块跳转。生命周期：详解 NavDestination 特有的 onShown/onHidden/onBackPressed 回调，区分其与组件生命周期的触发时机与使用场景。

2026-08-04 14:31:16 460

原创 HarmonyOS 信息传递载体 Want —— 显式与隐式启动详解

本文针对掌握Stage模型基础的鸿蒙开发者，深入解析Want对象的核心机制。Want作为HarmonyOS组件通信的载体，支持显式/隐式两种启动方式：显式通过bundleName+abilityName精准调用；隐式通过action、entities等字段动态匹配目标Ability。文章详解Want结构、module.json5的skills配置技巧，并提供参数传递、结果回调等实战示例，帮助开发者根据场景灵活选择启动策略，实现高效组件通信与跨应用协作。

2026-07-28 11:05:55 310

原创 HarmonyOS 状态管理 V2 —— @Observed、@ObjectLink 与深层状态响应

文章摘要本文针对已熟悉ArkUI状态管理V1的开发者，重点介绍V2版本的核心装饰器@Observed和@ObjectLink，解决V1中嵌套对象和数组属性无法自动刷新的痛点。通过@Observed装饰类实现深层属性观察，@ObjectLink支持子组件直接修改父组件对象属性，避免繁琐的整体替换。

2026-06-21 16:10:02 375

原创 HarmonyOS 工程目录、配置文件与 Stage 模型核心

本文深入讲解鸿蒙（HarmonyOS）工程目录结构及核心配置，面向已掌握UI构建和状态管理的开发者。文章解析工程级目录结构及各文件夹职责，详细说明应用全局配置app.json5和模块配置module.json5的关键字段含义。同时介绍Stage模型下UIAbility的生命周期、三种启动模式（singleton、multiton、specified）以及Want跨Ability跳转机制。通过理解这些核心概念，开发者将具备从全局视角配置和管理鸿蒙应用的能力，为复杂应用开发奠定基础。

2026-06-14 17:21:13 451

原创 HarmonyOS 页面生命周期与组件生命周期

本文系统讲解HarmonyOS页面与组件的生命周期机制，面向已掌握状态管理的鸿蒙开发者。重点解析：页面生命周期：onPageShow（显示时）、onPageHide（隐藏时）、onBackPress（拦截返回）的触发时机与使用场景；经典组件生命周期：aboutToAppear（创建前）、aboutToDisappear（销毁前）的执行顺序与资源管理；新版增强特性：新增onDidBuild（渲染后）、aboutToReuse（复用组件）等精细化控制点，对比新旧版本差异并提供选型建议，

2026-06-14 17:16:03 374

原创 HarmonyOS 状态管理 V1 —— @State、@Prop、@Link 与 AppStorage

本文深入讲解 HarmonyOS ArkUI 状态管理 V1 版本，核心内容包括：基础状态装饰器：@State用于组件私有状态管理；@Prop实现父子组件单向数据流；@Link实现父子双向数据绑定，并详细对比三者的适用场景。全局状态管理：介绍AppStorage的基本用法，实现跨组件/跨页面的状态共享，包括link()和prop()两种绑定方式。实战指南：通过计数器、开关组件等示例演示状态管理在实际开发中的应用，提供装饰器选型策略和注意事项。

2026-06-07 18:41:18 431

原创 HarmonyOS 基础 UI 构建 —— 组件、布局与沉浸式效果

鸿蒙应用开发：基础组件与布局容器指南摘要本文系统讲解了HarmonyOS应用开发中的基础组件和布局容器，帮助开发者快速构建美观实用的界面。主要内容包括：基础组件：详细介绍了Text、Button、Image等显示组件，TextInput、Progress、List等交互组件的用法和常用属性。布局容器：线性布局：Column垂直布局和Row水平布局弹性布局：Flex的灵活配置相对布局：RelativeContainer的锚点定位层叠布局：Stack的z轴排列网格布局：Grid的表格排列高级

2026-06-07 18:38:44 512

原创 TypeScript 模块与声明文件全解

本文面向已掌握 TypeScript 基础知识的开发者，系统讲解模块与声明文件的高级应用。内容涵盖：.d.ts 声明文件的编写与作用，declare 关键字的使用，通过 @types 安装第三方库类型，类型查找规则配置，为 JavaScript 库生成并发布类型声明，以及模块扩充（如扩展 express 的 Request 类型）和全局扩充技巧（如扩展 Array 原型）。帮助开发者高效协作第三方库并发布类型化项目，提升代码类型安全性与可维护性。

2026-05-31 18:05:08 251

原创 TypeScript 高级类型与工具类型全解

本文深入讲解 TypeScript 的高级类型特性，适合已掌握泛型、条件类型等基础知识的开发者。主要内容包括：映射类型：语法解析与内置类型（Partial、Readonly等），演示属性遍历与修饰符控制工具类型：详解Pick、Omit、Record等实用工具类型的实现原理与应用场景条件类型：讲解extends三元表达式、分布式条件特性及类型推断技巧类型编程：展示如何实现DeepReadonly、DeepPartial等递归类型，以及构建类型安全的EventBu

2026-05-28 15:59:48 405 1

原创 TypeScript 泛型全解 —— 泛型函数、泛型接口、泛型类与约束

本文系统讲解了 TypeScript 泛型的核心概念与应用，适合已掌握基础类型、接口和类的开发者。主要内容包括：泛型必要性：通过类型参数化解决 any 的类型丢失问题，实现类型安全与复用。泛型函数：支持多类型参数、类型推断与显式指定，保持输入输出类型关联。泛型接口：定义灵活的数据结构（如 Box<T>）和函数类型（如 Comparator<T>）。泛型约束：通过 extends 限制类型范围（如要求 length 属性），确保类型安全性。构造函数类型：利用 new 约束处理类工厂等场景，

2026-05-28 15:56:08 232

原创 TypeScript 泛型类与类的泛型约束

本文面向已掌握TypeScript类基础的开发者，重点讲解泛型在类中的应用。主要内容包括：1）类级别泛型参数的定义与多参数使用；2）通过extends约束泛型参数范围；3）方法级别泛型与类泛型的独立使用；4）通用数据存储类的设计实现；5）泛型默认类型设置。通过代码示例演示了如何创建类型安全的可复用数据结构，并特别说明泛型类与静态成员的关系。文章提供了从基础定义到实际应用的完整学习路径，帮助开发者掌握泛型类的核心概念和实践技巧。

2026-05-28 15:51:42 356

原创 TypeScript 类的类型 —— 作为类型使用

本文深入解析 TypeScript 类的双重身份（值/类型），重点讲解类作为类型注解、typeof获取构造函数类型、类与接口互换等核心用法。通过实例演示类在类型系统中的应用场景，包括工厂模式、依赖注入等实践，同时指出常见误区（如混淆实例类型与构造类型）。文章适合已掌握 TS 类基础的开发者，帮助理解类在类型层面的灵活运用，提升类型安全编程能力。（149字）

2026-05-28 15:50:08 406

原创 TypeScript 类的静态成员与静态方法

本文深入讲解 TypeScript 类的静态成员（static）特性，适合已掌握基础面向对象概念的开发者。主要内容包括：静态属性/方法的定义与访问限制、与实例成员的关键区别（归属、调用方式、访问范围）、静态修饰符（public/private/protected）的应用，以及继承中静态成员的行为（this动态绑定）。通过工具类、工厂模式、单例模式等典型场景，展示静态方法的实用价值，如MathUtils工具封装、实例缓存管理和全局唯一实例控制。文中包含丰富代码示例，帮助理解静态成员的设计思想与实践技巧

2026-05-28 15:49:04 436

原创 TypeScript 抽象类与抽象方法

摘要本文面向已掌握 TypeScript 类基础知识的开发者，系统讲解抽象类（abstract）的核心概念与应用。主要内容包括：抽象类定义：使用 abstract 声明不可实例化的基类，可包含具体方法和抽象方法抽象方法：强制子类实现的契约方法（无方法体），支持访问修饰符控制关键特性：可包含构造方法和字段初始化子类必须实现所有抽象方法（否则需声明为抽象类）与接口对比：抽象类适合共享状态和部分实现接口专注行为契约，支持多继承典型错误：实例化抽象类、未实现抽象方法、错误访问修饰符等通过实际代

2026-05-24 17:48:05 377

原创 TypeScript 继承与多态

摘要：本文面向已掌握 TypeScript 类基础的开发者，深入讲解类继承的核心概念。主要内容包括：使用 extends 实现继承，子类可访问父类的 public/protected 成员 super 的两种用法：调用父类构造函数（必须在子类构造函数首行）和调用父类方法方法重写机制与 TS 4.3+ 的 override 关键字（提供编译时重写校验）多态的实现：父类类型变量指向子类对象时，调用方法会执行子类实现访问修饰符在继承中的规则：protected 子类可见但外部不可访问，private 不

2026-05-24 17:47:27 433

原创 TypeScript 中的类基础

TypeScript 类核心语法摘要本文系统讲解了 TypeScript 类的核心语法，适合已掌握接口基础的开发者。主要内容包括：类定义：字段初始化、构造函数与方法定义的基本语法访问修饰符： public（默认）：任意访问 private：仅类内部访问 protected：类及子类访问只读属性：readonly修饰符限制属性仅初始化时可赋值参数属性：构造函数参数直接声明字段的简写方式类的类型：类同时作为构造函数（值）和实例类型特别提醒： private是编译时检查，运行时需用#实现真正私有参

2026-05-17 17:42:37 400

原创 TypeScript 类实现接口

摘要：本文介绍TypeScript中类通过implements实现接口的用法，包括单接口实现、多接口冲突处理、类型检查规则等核心概念。对比了接口与抽象类的差异，并给出适用场景建议：接口适合定义轻量契约和多继承，抽象类适合共享状态和默认实现。文中包含属性初始化、方法签名匹配等注意事项，以及综合示例演示接口与继承的组合使用，为面向对象编程奠定基础。（149字）

2026-05-17 17:41:44 413

原创 TypeScript 接口实战 —— 处理复杂嵌套对象

本文通过电商订单API案例，讲解如何设计TypeScript嵌套接口。采用自底向上方法，从最内层Address接口开始，逐步构建Customer、OrderItem等结构，最终形成完整的OrderData接口。文章介绍了处理可选字段、联合类型、深层只读等技巧，并建议通过接口组合减少嵌套深度。同时分享了与后端API对齐的实用方法，包括字段命名转换、泛型响应包装等，最后总结了过度嵌套、可选字段遗漏等常见问题。全文以实际场景演示了复杂数据结构的类型定义思路。

2026-05-10 18:37:15 415

原创 TypeScript 接口继承与混合类型

本文深入探讨TypeScript接口的高级特性，包括单继承与多继承语法、属性合并规则及冲突处理。重点解析接口如何继承类（含私有/保护成员），以及混合类型接口（兼具函数调用与对象属性）的实现技巧。对比接口继承与类型别名交叉的差异：接口继承提供更清晰的错误提示并支持类继承，而类型交叉更灵活但可能产生隐式never。通过DOM API和Promise等实例，展示混合接口的实际应用场景，帮助开发者在复杂类型设计中做出合理选择。

2026-05-10 18:34:39 382

原创 TypeScript 索引签名、只读数组与 keyof / typeof 入门

摘要：本文深入讲解TypeScript高级类型特性，适合已掌握接口基础的开发者。重点内容包括：索引签名：支持动态属性名（字符串/数字索引），需注意与普通属性的兼容规则及只读限制只读数组：三种定义方式（ReadonlyArray<T>、readonly修饰符、as const断言）及可变性特点 keyof运算符：提取对象键名的联合类型，支持泛型约束与索引签名处理 typeof运算符：获取变量/属性的静态类型，常与keyof或工具类型（如ReturnType）配合使用

2026-05-05 19:08:11 227

原创 TypeScript 接口的基本使用 —— 定义对象形状

TypeScript 接口核心用法指南摘要：本文为掌握 TypeScript 基础类型的开发者深入讲解接口的核心用法。主要内容包括：接口基本语法：定义对象形状，用于类型注解特殊属性：可选属性(?)、只读属性(readonly)的使用场景类型检查：对象字面量的多余属性检查机制及绕过方法类型对比：接口与类型别名的关键区别与适用场景选择高级特性：接口的声明合并特性及其优势

2026-05-05 19:07:12 265

原创 TypeScript 函数进阶 —— 可调用接口与构造签名

摘要：本文深入探讨 TypeScript 中可调用接口（Callable Interface）的进阶用法，帮助开发者描述复杂函数形态。主要内容包括：1）可调用接口的定义与调用签名语法，对比函数类型表达式的适用场景；2）实现同时具有属性和调用能力的函数对象；3）构造签名（new）的语法与工厂函数应用；4）泛型在可调用接口中的使用；5）常见错误分析。通过内置类型（如 Array、Promise）和实用案例（如带属性的加法器、依赖注入工厂），演示如何灵活应用这些特性。适用于已掌握基础函数类型的开发者提升能力

2026-04-26 18:47:32 379

原创 TypeScript 类型守卫

类型守卫与断言函数：精准收窄联合类型的 TypeScript 实践本文面向已掌握 TypeScript 基础的开发者，系统讲解类型收窄技术。通过 typeof、instanceof、in 运算符及自定义 is 类型守卫，实现智能类型推断，并介绍断言函数 asserts 的异常处理模式。核心要点： typeof 判断基本类型（需注意 null 的陷阱） instanceof 识别类实例（不适用于接口） in 运算符通过属性区分对象类型自定义守卫 value is T 实现复杂校验逻辑

2026-04-26 18:46:25 398

原创 TypeScript this 参数类型与全局 this

本文面向已掌握TypeScript基础的开发者，系统讲解函数中this的类型标注方法。主要内容包括：问题场景：JavaScript函数this的动态性导致类型不安全，TypeScript通过this参数约束上下文类型基本语法：在函数首参数位置声明this类型，编译时会被移除不影响运行时回调处理：解决回调函数this丢失的三种方案（箭头函数/bind/类型声明）接口定义：使用interface规范this的复杂结构全局扩展：通过declare global为全局对象添加类型声明

2026-04-20 18:46:24 434

原创 TypeScript 函数重载（Overloads）

TypeScript函数重载指南本文面向已掌握基础TS函数类型的开发者，解析函数重载的设计目的、语法规则与使用限制。核心内容：重载作用：解决参数类型/数量不同时返回值类型精确映射的问题语法结构：多个重载签名（无实现体） + 一个兼容的实现签名典型场景：参数类型不同（如string/string[]）、参数数量不同（如可选参数）注意事项：重载签名顺序影响匹配（具体优先）箭头函数不支持重载实现签名不可直接调用优势对比：重载比联合类型更适合返回值与参数类型严格绑定的场景。

2026-04-20 18:44:44 429

原创 TypeScript 函数参数与返回值类型注解

本文系统讲解 TypeScript 函数类型系统，涵盖参数与返回值的类型注解规则，适合已掌握基础类型的开发者。主要内容包括：参数注解：必选/可选参数(?)、默认参数的类型推断、剩余参数(...)的数组类型返回值处理：显式类型标注、void与never的特殊场景、对象返回类型函数类型表达式：箭头函数形式的类型定义、作为参数/返回值的使用常见问题：可选参数位置限制、默认参数混用、返回值类型意外推断等通过代码示例演示函数声明、回调函数类型、复杂返回值等实际应用场景，帮助开发者规范函数类型设计。

2026-04-06 16:48:55 396

原创 TypeScript 类型断言与非空断言

本文深入解析 TypeScript 中的类型断言（as/<>）与非空断言（!）的核心用法与风险。重点包括：类型断言：覆盖编译器推断（如 DOM 元素类型指定），但需确保类型兼容性；非空断言：强制排除 null/undefined，可能掩盖运行时错误；对比方案：优先推荐类型守卫、可选链（?.）等更安全的类型收窄方式；适用场景：断言适用于开发者确知类型而编译器无法推断的情况（如第三方库交互、逻辑确保非空的场景）。风险提示：断言仅影响编译时，滥用可能导致运行时崩溃，应谨慎使用。

2026-04-06 16:45:51 420

原创 TypeScript 类型别名、字面量类型、联合类型与交叉类型

摘要：本文面向已掌握TypeScript基础类型的开发者，深入讲解如何通过类型别名（type）、字面量类型、联合类型（|）和交叉类型（&）构建更灵活的类型系统。重点内容包括：类型别名：定义复杂类型结构，对比type与interface的差异字面量类型：字符串/数字的具体值作为类型，使用as const锁定推断联合类型：表示"或"关系，需注意属性访问限制交叉类型：合并多个类型为"且"关系，处理属性冲突。通过组合这些特性，可实现更精确的类型约束与代码复用

2026-03-31 22:51:02 456

原创 TypeScript 特殊类型与空值安全

TypeScript 特殊类型与空值安全指南本文面向已掌握基础类型的开发者，深入解析特殊类型的设计用途与安全实践： any与unknown：避免any的类型污染，优先用unknown强制类型收窄 void与never：区分无返回值函数(void)和永不返回函数(never)，后者可用于穷尽检查空值处理：开启strictNullChecks严格校验null/undefined 使用联合类型明确允许空值可选链?.和非空断言!的适用场景与风险。通过合理运用这些类型特性，可保持灵活性和增强代码类型安全性。

2026-03-31 22:48:07 575

空空如也

空空如也