fec-refactoring-encapsulation git:20260901.387d97aA

Immutable. This exact content never changes and is served at /api/v1/blob/2b9b224bed3d5fe0.

---
name: fec-refactoring-encapsulation
description: 保持行为的前端重构主要涉及封装类重构，已经选定或正在评估对应手法，需要查询该 family 的操作步骤、风险与 JavaScript/TypeScript/React/Vue 适配时。
---

# 封装类重构

## 概览
只有在证据和前置条件支持时才使用对应手法。一次只执行一个主要结构变换，并在完成后立即验证。

## 执行流程
1. 在[封装类重构详细卡片](references/encapsulation-refactorings.md)确认手法和前置条件。
2. 记录受影响行为与差异预算。
3. 只执行该手法最小可行的一步。
4. 在组合下一手法之前验证当前步骤。
5. 公共契约、生命周期、状态身份或实际范围超出预期时停止并重新评估。

## 快速索引
详细 Reference 包含本 family 的 9 个标准手法，每项均包括意图、信号、不适用条件、操作步骤、行为保持检查、相关坏味道、组合关系、JS/TS/React/Vue 注意事项、前端适配和原创示例。

## 常见错误
- 只根据手法名称套用，不核对前置条件。
- 一个 diff 同时混入多个结构目标。
- 把经典 class 形式机械套进现代 React/Vue。
- 相关行为没有覆盖时，仅凭“测试通过”就声称行为已得到证明。