1.�ʼ��ƶ���Դ��
2.DeepSpeed源码笔记3优化器
3.EasyLogger源码学习笔记（3）
4.UE4学习笔记（1）：UE源码下载编译+安卓打包
5.Vuex 4源码学习笔记 - mapState、笔记mapGetters、移动源笔mapActions、端源mapMutations辅助函数原理（六）
6.EasyLogger源码学习笔记（5）

�ʼ��ƶ���Դ��

       这篇文章将深入分析 MobX 的码开码 observableObject 数据类型的源码，同时探讨使用 Proxy 和 Object.defineProperty 这两种实现方案来劫持对象行为的记源策略。通过分析，笔记创E资源源码网我们能够理解 MobX 在创建 observableObject 时是移动源笔如何同时采用这两种方案，并在创建时决定使用哪一种。端源

       首先，码开码回顾 observableArray 的记源实现方式，通过 Proxy 代理数组的笔记行为，转发给 ObservableArrayAdministration 来实现响应式修改的移动源笔逻辑。同样，端源我们已经讨论过 observableValue 的码开码实现，通过一个特殊的记源类 ObservableValue 直接使用其方法，无需代理。

       对于 observableObject 的实现机制，其特点在于同时采用了上述两种方案，并且在创建时决定使用哪一种。让我们回到文章中提到的工厂方法，其中根据 options.proxy 的值来决定使用哪一种方案。

       在 options.proxy 为 false 的情况下，使用第一条路径来实现 observableObject。这通过直接返回 extendObservable 的结果，其中 extendObservable 是一个工具函数，用于向已存在的目标对象添加 observable 属性。属性映射中的所有键值对都会导致目标上生成新的 observable 属性，并且属性映射中的任意 getters 会被转化为计算属性。

       这里首先根据 options 参数选择特定的 decorator，这个过程与之前在第一篇文章中通过 options 参数选择特定的 enhancer 类似。实际上，这里的 decorator 起到了类似的作用，甚至在创建 decorator 这个过程本身也需要通过 enhancer 参数。

       至于 decorator 和 enhancer 之间的耦合机制，文章中详细解释了 createDecoratorForEnhancer 和 createPropDecorator 函数，通过这些函数我们能够了解到它们是如何将 decorator 和 enhancer 联系起来的。

       接下来，文章深入分析了 decorator 的作用机制，包括它如何决定是否立即执行，以及在不立即执行时如何将创建 prop 的ourmsg源码相关信息保存下来。通过 initializeInstance 函数，我们了解了如何解决 # 问题，这涉及到如何正确处理那些在创建时未被立即执行的 prop。

       最终，通过为 target 对象创建 ObservableObjectAdministration 管理对象，并通过 $mobx 和 target 属性将它们关联起来，我们完成了 observableObject 的创建。如果传入的 properties 不为空，则使用 extendObservableObjectWithProperties 来初始化。这里的代码逻辑相对简单，主要遍历 properties 中的所有键并调用对应的 decorator。

       文章还指出，虽然在第一条路径中，使用 Object.defineProperty 重写了 prop 的 getter 和 setter，但在 MobX 4 及以下版本中，使用 Proxy 来实现 observableObject 的逻辑更为常见。Proxy 特性在 ES6 引入后，提供了更强大的能力来劫持对象的行为，不仅限于 getter 和 setter，还包括对象的其他行为。

       最后，文章总结了使用 Proxy 方案的优点，包括能够更全面地劫持对象的行为，而不仅仅是属性的 getter 和 setter。Proxy 方案在实现双向绑定时，能够提供更灵活和强大的功能。同时，文章也提到了两种方案的局限性，尤其是在处理对象属性的可观察性方面，Proxy 方案在某些情况下可能更具优势。

DeepSpeed源码笔记3优化器

       DeepSpeedZeroOptimizer_Stage3 是一个用于训练大模型的优化器，专门针对zero stage 3的策略。它通过将参数W划分为多份，每个GPU各自维护优化器状态、梯度和参数，以实现高效并行计算。具体实现过程如下：

       在进行前向计算时，每个GPU负责其部分数据，所有GPU的qwebengine源码数据被分成了三份，每块GPU读取一份。完成前向计算后，GPU之间执行all-gather操作，合并所有GPU的参数W，得到完整的W。

       在执行反向传播时，同样进行all-gather操作，收集所有GPU的完整W，然后执行梯度计算。完成反向传播后，立即释放不属于当前GPU管理的W。

       在计算梯度后，通过reduce-scatter操作聚合所有GPU的梯度G，得到完整的梯度。接着，释放非当前GPU管理的梯度G。最后，使用当前GPU维护的部分优化器状态O和聚合后的梯度G来更新参数W，无需额外的allreduce操作。

       初始化阶段包括设置参数和配置，如optimizer、flatten、unflatten、dtype、gradient_accumulation_dtype等。这些配置决定了优化器的运行方式和性能。初始化还包括创建参数分组和设置特定的分片操作。

       分配模型参数到各个GPU上，通过多种方法如创建参数分组、创建参数子分组等进行细致的划分和管理。这些分组和子分组的创建和管理，是为了更有效地进行梯度聚合和参数更新。

       在执行反向传播后，调用LossScaler进行梯度计算，随后通过特定的钩子函数（如reduce_partition_and_remove_grads）进行梯度聚合和释放。

       执行优化器的step方法时，进行归一化梯度计算、更新参数和优化器状态，并在完成后清理和更新模型参数。actionform源码此过程包括执行反向梯度聚合、更新模型参数权重、清理优化器状态和参数。

       DeepSpeedZeRoOffload模块则负责模型参数的划分和管理工作，包括初始化、参数划分和状态更新等。初始化阶段会根据配置将参数分配到不同GPU上，并进行状态更新和参数访问的优化。

       在进行参数划分时，首先将模型参数划分为非划分和划分的参数，并根据划分状态进一步处理。初始化外部参数后，会更新模块的状态，包括所有参数的存储位置和管理策略。

       在执行partition_all_parameters方法时，根据GPU数量和参数大小计算每个GPU需要处理的部分，从模型参数中提取并分割到对应的GPU上，释放原参数并更新参数状态。

       Init过程涉及到初始化配置、实现特定方法（如all_gather、partition等）和状态更新，确保模型参数能被正确地在不同GPU间共享和管理。对于特定的GPU（如主GPU），还会使用广播操作将参数分发给其他GPU。

EasyLogger源码学习笔记（3）

       在EasyLogger源码学习中，枚举变量的使用十分直观。定义枚举类型后，可以直接在代码中操作，提升可读性和代码清晰度。

       va_list是一个字符指针，用于在可变参数表中导航和取值。首先，你需要定义一个va_list类型的变量ap，然后通过va_start函数初始化，ap指向变参表的第一个参数，后续的参数获取通过va_arg完成，它会根据指定类型从ap中提取并返回值，同时更新ap的位置。使用完毕后，傲视源码记得调用va_end来释放ap，以确保程序的健壮性。

       对于字符串处理，vsnprintf提供了格式化输出功能，它能在指定长度内限制输出，避免溢出。例如，snprintf函数可以格式化字符串并存储在给定的缓冲区中，确保字符数不超过预设的大小。

       在查找字符串时，strstr函数用于在haystack中查找needle首次出现的位置，但不包括结束符。在函数定义中，诸如va_start(args, format)这样的语句用于处理可变参数。

       在elog_output函数中，tag_sapce的初始化出现疑问，原因在于需要保证标签对齐，通过memset函数在前面填充空格。这里，用'ELOG_FILTER_TAG_MAX_LEN / 2 - tag_len'的长度来确保足够的空间，而不是'ELOG_FILTER_TAG_MAX_LEN + 1'，因为这样可以避免不必要的填充。

       在elog_find_tag函数中，返回值的问题在于它实际返回了日志的tag及其后续信息，而不是仅限于tag本身。因此，需要检查并修正这个逻辑，以确保返回正确的内容。

UE4学习笔记（1）：UE源码下载编译+安卓打包

       注：该笔记以UE4..2在windows平台为例，vs版本为

       1.关联github和Epic账户

       要在github上获取UE4源码需要先关联账户，否则找不到源码，网页

       按照官网提供流程即可完成 GitHub上的虚幻引擎 - Unreal Engine

       记得确认邮件，否则还是（当初就是忘记了，卡了好一会儿）

       2.下载UE4源码

       在 Releases · EpicGames/UnrealEngine (github.com)中选择自己需要的版本（我使用的是4..2），这步很简单，但需要注意的是还需要将Commit.gitdeps.xml文件也一并下载，用于替换同名文件（有些版本则没有这样的文件），不替换的话后续会报错（之后步骤中会提到）

       解压后目录如下：

       3.执行bat文件

       （1）点击运行setup.bat，没有替换Commit.gitdeps.xml文件可能会出现如下问题：

       （2）点击运行GenerateProjectFiles.bat，此过程可能会出现如下问题：

       未找到框架 .NETFramework Version=v4.6.2

       只需要在VS Installer中选中安装就行：

       完成后会生成UE4.sln文件

       4.生成

       VS打开UE4.sln，开始生成：

       但是生成过程中我出现了这样的问题：

       UE4 fatal error C: 编译器限制: 达到内部堆限制

       error C: 超过了 PCH 的虚拟内存范围问题解决

       我出现这样问题的原因是我的C盘空间不够大（分区的时候给的比较少），托管系统设置在C盘，导致无法分配足够的虚拟内存，设置为空间足够的盘即可。

       步骤：电脑->属性->高级系统设置->高级->性能设置->高级->更改

       OK，成功编译完成

       5.安卓打包

       该过程有官方文档，并且比较繁琐，直接给出链接：

       设置虚幻的Android SDK和NDK | 虚幻引擎文档 (unrealengine.com)

       UE部署到Android以及杂症的解决 - 知乎 (zhihu.com)

       我就提一下自己遇到的问题，在UE4中进行安卓打包的时候遇到了这样的问题：

       原因在于SetupAndroid.bat中，SDK Platform的版本选择是，而在UE项目设置->平台 - Android SDK中的SDK API Levle默认选择latest。但是我安装AS的时候默认给我安装了最新的Android API （此时latest指向的是版本），导致冲突。解决方法是UE项目设置中手动设置指定版本，或者在AS中卸载高于版本的Android API。

       OK，打包成功！！！

       6.打开游戏

       但是，是的，还有但是（都最后一步了，还有问题OVO！！！），在手机上下载安装，打开后是这样的：

       原来是因为打包除了生成apk文件还生成了obb，至于Google Play Store Key应该就是一个密钥了。

       解决方法是在UE项目设置->Android中勾选“将游戏数据打包至.apk中”，我们可以看到对这个勾选项的解释：

       行，勾选后重新打包，成功运行：

Vuex 4源码学习笔记 - mapState、mapGetters、mapActions、mapMutations辅助函数原理（六）

       在前一章中，我们通过了解Vuex的dispatch功能，逐步探索了Vuex数据流的核心工作机制。通过这一过程，我们对Vuex的整体运行流程有了清晰的把握，为深入理解其细节奠定了基础。本章节，我们将聚焦于Vuex的辅助函数，包括mapState、mapGetters、mapActions、mapMutations以及createNamespacedHelpers，这些函数旨在简化我们的开发流程，使其更符合实际应用需求。

       请注意，这些辅助函数在Vue 3的Composition API中不适用，因为它们依赖于组件实例（this），而在Setup阶段，this尚未被创建。因此，它们仅适用于基于选项的Vue 2或Vue 3经典API。

       以mapState为例，它允许我们以计算属性的形式访问Vuex中的状态。当组件需要获取多个状态时，通过mapState生成的计算属性可以显著减少代码冗余。若映射的计算属性名称与state子节点名称相同，只需传入字符串数组。此外，通过对象展开运算符，我们能轻松地在已有计算属性中添加新的映射。

       深入代码层面，mapState的核心功能在src/helpers.js文件中得以实现。通过normalizeNamespace函数统一处理命名空间和map数据，然后利用normalizeMap函数将数组或对象格式数据标准化，最终返回一个封装后的函数对象。通过这种方式，mapState有效简化了状态访问的实现。

       mapGetters、mapMutations、mapActions遵循相似的模式，通过normalizeNamespace统一输入，然后使用normalizeMap统一数据处理，最后返回对象格式的函数集合，支持对象展开运算符的使用。这些函数简化了获取、执行actions和mutations的过程。

       createNamespacedHelpers则是为管理命名空间模块提供便利。通过传入命名空间值，它生成一组组件绑定辅助函数，简化了针对特定命名空间的模块操作。此函数通过bind方法巧妙地将namespace参数绑定到返回的函数集合中，实现了高效、灵活的命名空间管理。

       本章节对mapState的实现原理进行了深入分析，并展示了其余辅助函数的相似之处。通过理解这些函数的工作机制，我们能更高效地应用Vuex，优化组件间的交互与状态管理。利用这些工具，开发者能够更专注于业务逻辑的实现，而不是繁琐的状态获取和管理。

       在探索更多前端知识的旅程中，让我们一起关注公众号小帅的编程笔记，每天更新精彩内容，与编程社区一同成长。

EasyLogger源码学习笔记（5）

       在EasyLogger源码的学习中，我们了解到日志对象使用了互斥锁以确保同一时刻只有一个线程能进行操作，保证了日志管理的安全性与高效性。

       对于异步输出，EasyLogger通过信号量实现了优化。当需要等待执行时，某个线程会被阻塞，以减少CPU的占用。这一特性允许用户单独设置异步输出的日志等级，提高系统的灵活性与可控性。

       在文件输出时，使用了信号量集合，其中仅包含一个信号量。这一设计确保了同时只有一个线程能向文件中写入日志，避免了多线程并发写入导致的文件混乱。

       日志输出的多样选择体现了EasyLogger的灵活性，无论是输出到文件还是串口，都可以根据需要配置是否采用异步输出，以适应不同的应用场景与性能需求。

       此外，sem_post函数用于解锁由semby指定的信号量，执行对特定信号量的解锁操作。而semop函数则用于执行一组预先定义的信号量操作，适用于对多个信号量进行原子性操作。

       在信号量集合仅包含一个信号量的情况下，使用sem_post函数进行操作可能直接替代使用semop函数。这一设计简化了信号量管理，提高了代码的可读性和效率。

easylogging源码学习笔记（6）

       `LOG` 是默认日志、CLOG自定义日志、LOG_IF条件日志

       特殊日志

       LOG_EVERY_N、LOG_AFTER_N、LOG_N_TIMES

       for (int i = 1; i <= ; ++i) {

       LOG_EVERY_N(2, INFO) << "Logged every second iter";

       }// 5 logs written; 2, 4, 6, 7,

       for (int i = 1; i <= ; ++i) {

       LOG_AFTER_N(2, INFO) << "Log after 2 hits; " << i;

       }// 8 logs written; 3, 4, 5, 6, 7, 8, 9,

       for (int i = 1; i <= ; ++i) {

       LOG_N_TIMES(3, INFO) << "Log only 3 times; " << i;

       }// 3 logs writter; 1, 2, 3

       条件日志和特殊日志可以搭配使用

       * `VLOG_IF(condition, verbose-level)`

       * `CVLOG_IF(condition, verbose-level, loggerID)`

       * `VLOG_EVERY_N(n, verbose-level)`

       * `CVLOG_EVERY_N(n, verbose-level, loggerID)`

       * `VLOG_AFTER_N(n, verbose-level)`

       * `CVLOG_AFTER_N(n, verbose-level, loggerID)`

       * `VLOG_N_TIMES(n, verbose-level)`

       * `CVLOG_N_TIMES(n, verbose-level, loggerID)`

       日志详细等级判定

       if (VLOG_IS_ON(2)) {

       // Verbosity level 2 is on for this file

       }

       性能追踪

       * `TIMED_FUNC(obj-name)`

       * `TIMED_SCOPE(obj-name, block-name)`

       * `TIMED_BLOCK(obj-name, block-name)`

       这些宏实际上都是关于el::base::type::PerformanceTrackerPtr，一个指向el::base::PerformanceTracker的指针

       #if defined(ELPP_FEATURE_ALL) || defined(ELPP_FEATURE_PERFORMANCE_TRACKING)

       PerformanceTracker::PerformanceTracker(const std::string& blockName,

       base::TimestampUnit timestampUnit,

       const std::string& loggerId,

       bool scopedLog, Level level) :

       m_blockName(blockName), m_timestampUnit(timestampUnit), m_loggerId(loggerId), m_scopedLog(scopedLog),

       m_level(level), m_hasChecked(false), m_lastCheckpointId(std::string()), m_enabled(false) {

       #if !defined(ELPP_DISABLE_PERFORMANCE_TRACKING) && ELPP_LOGGING_ENABLED

       // We store it locally so that if user happen to change configuration by the end of scope

       // or before calling checkpoint, we still depend on state of configuration at time of construction

       el::Logger* loggerPtr = ELPP->registeredLoggers()->get(loggerId, false);

       m_enabled = loggerPtr != nullptr && loggerPtr->m_typedConfigurations->performanceTracking(m_level);

       if (m_enabled) {

       base::utils::DateTime::gettimeofday(&m_startTime);

       }

       #endif // !defined(ELPP_DISABLE_PERFORMANCE_TRACKING) && ELPP_LOGGING_ENABLED

       }

       在构造函数中获取一个时间，

       PerformanceTracker::~PerformanceTracker(void) {

       #if !defined(ELPP_DISABLE_PERFORMANCE_TRACKING) && ELPP_LOGGING_ENABLED

       if (m_enabled) {

       base::threading::ScopedLock scopedLock(lock());

       if (m_scopedLog) {

       base::utils::DateTime::gettimeofday(&m_endTime);

       base::type::string_t formattedTime = getFormattedTimeTaken();

       PerformanceTrackingData data(PerformanceTrackingData::DataType::Complete);

       data.init(this);

       data.m_formattedTimeTaken = formattedTime;

       PerformanceTrackingCallback* callback = nullptr;

       for (const std::pair& h

       : ELPP->m_performanceTrackingCallbacks) {

       callback = h.second.get();

       if (callback != nullptr && callback->enabled()) {

       callback->handle(&data);

       }

       }

       }

       }

       #endif // !defined(ELPP_DISABLE_PERFORMANCE_TRACKING)

       }

       在析构函数中获取一个时间，处理时间data，使用PerformanceTrackingCallback类型指针callback，并在callback->handle(&data)中处理输出。

       由于定义了ELPP_FEATURE_PERFORMANCE_TRACKING，因此在初始化（INITIALIZE_EASYLOGGINGPP）中实际上是安装了一个base::DefaultPerformanceTrackingCallback。

       在PerformanceTracker类的handle函数中，callback是一个PerformanceTrackingCallback类型指针，由于安装的是DefaultPerformanceTrackingCallback对象，因此是一个基类指针指向了派生类对象。处理输出的逻辑在DefaultPerformanceTrackingCallback类的handle函数中。

       DefaultPerformanceTrackingCallback类的handle函数首先会将数据成员m_data的指针赋值给函数参数，并创建一个base::type::stringstream_t类型的对象ss用于构建输出内容。根据m_data的dataType，输出不同的信息。在输出时，会使用el::base::Writer类构造并输出内容。

Vue Router 源码学习笔记4 - pushState和replaceState的实现

       在Vue Router中，HTML5History的push和replace操作主要通过util/push-state.js中的相应函数来执行，它们依赖window.history.pushState和window.history.replaceState API。对于HTML5History，如果浏览器支持，就按照标准流程进行，即利用pushState或replaceState改变浏览器的历史记录，而不会导致页面刷新。

       对于HashHistory，浏览器支持与否对操作方式有影响。若支持，同样采用类似方法，通过pushState设置hash部分，replaceState则调用window.location.replace替换当前URL。然而，如果浏览器不支持pushState，会直接操作window.location更改URL，以#符号为标志。

       MDN文档中提到，pushState需要三个参数：状态对象、标题（通常忽略）和可选的URL。而replaceState与pushState类似，只是替换当前历史项，而非新增，尽管它会在浏览器历史中生成新的记录。

       当路由更改后，紧接着是视图的同步更新。详细了解这两个方法的使用，可以参考MDN文档：developer.mozilla.org/zh-CN/docs/Web/API/History/pushState。

       继续深入学习，确保在实际项目中正确运用这些原理，实现无缝的路由切换。