一、结论

getContext 从 HarmonyOS API 18 开始正式废弃，官方推荐使用 UIContext.getHostContext()替代。

官方给的解释比较抽象，所以我重新总结了如下原因：

核心原因是旧方法存在作用域不稳定、类型安全缺陷、架构耦合度高等问题，无法适配鸿蒙系统分布式协同、多元设备形态（折叠屏/多屏协同）的演进需求。 新方法通过分层设计实现上下文安全管理，支持空值校验、编译时类型检查，且适配复杂场景，同时降低运行时开销。

二、问题本质与核心差异

1. 废弃核心原因（getContext的设计缺陷）

2. 新旧方法核心差异

三、代码实现和详细解释

1、组件内获取（最常用）

适用于页面组件、自定义组件，需通过类型收窄处理undefined，避免空指针异常：

import common from '@ohos.app.ability.common';

/**
 * 组件内获取HostContext示例（API 18+ 推荐）
 */
@Entry
@Component
struct HostContextTestPage {
  build() {
    Button('触发Ability跳转')
      .onClick(() => this.useHostContext())
  }

  private useHostContext() {
    // 1. 获取UI上下文容器，再提取宿主上下文（无需手动注解类型，依赖TS推断）
    const context = this.getUIContext().getHostContext();

    // 2. 类型收窄：必须先校验上下文非空（核心安全步骤）
    if (context) {
      // 3. 按需断言为UIAbilityContext（调用startAbility等特有方法时）
      const uiAbilityContext = context as common.UIAbilityContext;
      
      // 4. 安全使用上下文执行操作（如跳转Ability、获取应用信息）
      uiAbilityContext.startAbility({
        bundleName: 'com.example.myapp',
        abilityName: 'SecondAbility'
      });

      console.log('应用包名：', uiAbilityContext.applicationInfo.bundleName);
    } else {
      // 5. 异常处理：组件未挂载/上下文失效时
      console.error('获取HostContext失败，原因：组件未挂载或宿主Ability已销毁');
    }
  }
}

2、非UI场景获取（工具类/服务）

非组件环境（如工具类、全局服务）无法直接调用getUIContext()，需通过缓存Ability上下文实现：

（1）在EntryAbility初始化时缓存上下文

// EntryAbility.ts（应用入口）
import UIAbility from '@ohos.app.ability.UIAbility';
import { AppStorage } from '@ohos/ui';
import common from '@ohos.app.ability.common';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // 缓存UIAbility的Context到AppStorage（全局可访问）
    AppStorage.setOrCreate<common.UIAbilityContext>('appContext', this.context);
    console.log('Ability上下文缓存完成');
  }

  onDestroy() {
    // 销毁时清除缓存，避免内存泄漏
    AppStorage.delete('appContext');
  }
}

（2）在工具类中读取缓存

// utils/ContextUtil.ets（工具类）
import { AppStorage } from '@ohos/ui';
import common from '@ohos.app.ability.common';

/**
 * 非UI场景获取上下文工具类
 */
export class ContextUtil {
  /**
   * 从缓存获取应用上下文
   */
  public static getAppContext(): common.UIAbilityContext | undefined {
    // 从AppStorage读取缓存的上下文
    const context = AppStorage.get<common.UIAbilityContext>('appContext');
    if (!context) {
      console.error('非UI场景获取上下文失败：未找到缓存的AbilityContext');
    }
    return context;
  }
}

// 调用示例
const appContext = ContextUtil.getAppContext();
if (appContext) {
  // 安全使用上下文（如读取应用配置）
  console.log('应用沙箱路径：', appContext.filesDir);
}

四、使用说明

1、类型处理核心原则

（1）不要直接设置变量属性为Context（如const context: Context = this.getUIContext().getHostContext()），会触发类型不兼容报错； （2）必须先通过if (context)进行空值校验，再根据需求断言为UIAbilityContext/ExtensionContext等具体类型； （3） 少用强制类型断言，优先依赖TS类型推断减少错误。

2、异常场景处理

（1）组件未挂载（如在aboutToAppear前调用）：getHostContext()返回undefined，需在组件生命周期回调后使用。 （2）非UI环境调用：必须通过缓存上下文实现，禁止在工具类中直接调用this.getUIContext()。 （3）设备流转/分屏切换：上下文会动态更新，需避免长期缓存上下文实例，建议用时获取。

3、注意事项

API 18+：直接使用getHostContext()，禁止使用getContext()（编译器会提示废弃警告）； API 12-17：可兼容使用getHostContext()（推荐），或保留getContext()但需增加类型校验； 低版本（<API 12）：无getHostContext()，需继续使用getContext()，但需添加生命周期判断避免失效。

六、资料引用

getContext废弃官方说明： https://developer.huawei.com/consumer/cn/doc/architecture-guides/tools-v1_2-ts_309-0000002443435465#section14148187125815

定位UIContext错误问题 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-wrong-uicontext-debug#%E5%AE%9A%E4%BD%8Duicontext%E9%94%99%E8%AF%AF%E9%97%AE%E9%A2%98

【HarmonyOS 6】为什么getContext 废弃，使用getHostContext说明 https://developer.huawei.com/consumer/cn/blog//topic/03199322078247044