如何验证已安装的是非PyPI的自定义内部Python包？

针对内部包（如package1、package2、package3）和PyPI上同名包易被用户误装的问题，有几种更通用的验证方案，能覆盖直接导入单个包的场景，比仅在package0中做检查更全面：

1. 给内部包添加专属标识与自检逻辑 #

直接在每个内部包的__init__.py中添加唯一标识，并加入自检代码，从根源拦截错误版本：

# package1/__init__.py
# 定义内部包专属标识
__internal_org__ = "our-organization"

# 自检逻辑
try:
    assert __internal_org__ == "our-organization"
except (NameError, AssertionError):
    raise ImportError(
        "检测到非内部版本的package1，请卸载后从公司内部源重新安装"
    )

不管用户是直接导入package1，还是通过其他包间接导入，都会触发这个检查。

2. 通过安装路径验证 #

内部包通常会安装到带有公司标识的特定路径（比如内部镜像指定的目录），可以通过包的文件路径判断合法性：

# package1/__init__.py
import os

# 假设内部包的安装路径包含"our-company"特征字符串
pkg_path = os.path.abspath(__file__)
if "our-company" not in pkg_path:
    raise ImportError(
        "你安装的是PyPI公开版本的package1，请切换到公司内部源重新安装"
    )

这种方法不需要额外维护标识字段，依赖内部环境的路径特征，适合统一部署的场景。

3. 从分发层面约束安装源 #

从根源减少误装的可能：

• 强制用户使用公司内部PyPI镜像源，通过pip config set global.index-url https://internal-pypi.our-org.com/simple/设置全局默认源，避免用户误连公共PyPI。
• 在项目的requirements.txt中明确指定内部源：

  --index-url https://internal-pypi.our-org.com/simple/
  package1==1.0.0
  package2==2.3.1
  

对你现有方案的补充 #

你在package0中做检查的方法能覆盖部分场景，但确实无法处理用户直接导入单个包的情况。上述方案可以和现有方法结合，形成多层验证，进一步降低误装概率。

内容的提问来源于stack exchange，提问作者Jayson Vavrek