Embedded interpreters: No way to extend `sys.path`

Feature or enhancement

Proposal:

Setting up an embedded Python interpreter often involves augmenting sys.path with some application-specific subdirectories, so as not to pollute the system's normal Python installation.

Unfortunately, PyConfig only affords either replacing the default path wholesale, or leaving it as-is (via module_search_paths_set). There appears to be no way to augment sys.path with application-specific directories and no documented way to retrieve the default contents of sys.path.

A workable solution might be to enhance cfg.module_search_paths_set so that when it's set to 2 or 3, the application's paths shall be prepended / appended to sys.path instead of replacing it.

Has this already been discussed elsewhere?

I have already discussed this feature proposal on Discourse

Links to previous discussion of this feature:

https://discuss.python.org/t/embedding-how-do-i-extend-sys-path/75734

先阅读 PyConfig 文档以及 issue 中描述的 module_search_paths_set 行为，然后阅读链接的 Discourse 讨论，了解之前的设计背景。确定应用专用路径应如何与默认的 sys.path 结合，以及文档中应如何描述 API 行为；完成内容应包括经协商一致的实现以及相应的文档或测试。