Skip to content

Clarify lazy loading explanation in documentation #148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
SunnyHaze merged 1 commit into from
Dec 20, 2025
Merged

Clarify lazy loading explanation in documentation #148

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/zh/notes/dev_guide/lazy_loader.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ createTime: 2025/07/12 17:35:02
permalink: /zh/dev_guide/lazy_loader/
---
# 必看-基于lazy_loader的算子开发
因为Dataflow中有大量基于不同Python库，不同依赖的开发的算子。如果解释器一次性import所有算子和对应依赖，会带来极大的负载压力。而且随着未来各种库的增多，可能会有一些库是互斥的。所以`Lazyload`懒加载是必要的。懒加载，即只在算子被import的时候加载的时候import其所有的依赖。
因为Dataflow中有大量基于不同Python库，不同依赖的开发的算子。如果解释器一次性import所有算子和对应依赖，会带来极大的负载压力。而且随着未来各种库的增多，可能会有一些库是互斥的。所以`Lazyload`懒加载是必要的。懒加载，即仅在算子被导入（import）时，才加载其所需的全部依赖。

感谢[Zimo Meng](https://github.com/MOLYHECI)实现了自动识别语法树的lazyloader，并可以被VSCode正常高亮。开发新算子的时候，除了正常的写算子逻辑的python脚本，还需要注意写入必要的import以保证`Dataflow`框架能正常索引到对应的文件并import。

Expand All @@ -22,4 +22,4 @@ if TYPE_CHECKING:
...
```

请务必按照上述格式，不要添加其他位置的`from xxxx import *`，以免失去`懒加载`的能力。
请务必按照上述格式，不要添加其他位置的`from xxxx import *`，以免失去`懒加载`的能力。