Pyright依赖指定差异及Pre-Commit自动读取依赖配置问询

我用Poetry管理Python项目依赖（配置文件为pyproject.toml），新增python-dotenv依赖后，本地执行poetry run pyright完全正常，但Pre-Commit中的Pyright Hook执行时却报错，提示无法解析dotenv的导入语句。给Hook添加additional_dependencies: [python-dotenv]后问题解决，但之前使用beautifulsoup4、rapidfuzz等依赖时，并没有遇到这种情况，想请教两个问题：

1. 为何部分依赖无需在Pyright Hook中指定？ #

Pre-Commit的每个Hook都会在独立虚拟环境中运行，和本地Poetry创建的项目环境完全隔离。Pyright本身内置了大量常见Python库的类型存根（type stub），像beautifulsoup4、rapidfuzz这类使用广泛的库，Pyright预先包含了它们的类型定义，不需要Hook环境中实际安装这些包就能识别导入语句。

而python-dotenv属于Pyright未内置类型存根的库，同时它的包本身也没有附带完整的类型提示文件，只有当Hook环境实际安装该包后，Pyright才能读取到对应的类型信息，所以没装的话就会报错无法解析导入。

2. 能否配置Pre-Commit自动读取.toml中的依赖以减少重复配置？ #

可以，推荐两种实用方案：

方案一：用本地Hook调用Poetry环境的Pyright #

直接绕过Pre-Commit官方的Pyright Hook，改用本地Hook调用Poetry项目环境里的Pyright，完全共享项目依赖，无需重复配置。在.pre-commit-config.yaml中添加如下内容：

- repo: local
  hooks:
    - id: pyright
      name: pyright
      entry: poetry run pyright
      language: system
      types: [python]
      pass_filenames: true

这种方式最省心，彻底复用Poetry的依赖环境，不用额外维护Hook的依赖列表。

方案二：动态导出Poetry依赖到Hook配置 #

通过poetry export命令把pyproject.toml中的依赖导出为requirements格式，再让Pre-Commit Hook读取，但需要同步依赖更新：

1. 执行导出命令（按需包含开发依赖）：

   poetry export --without-hashes --format=requirements.txt > requirements-dev.txt
   

2. 在Pre-Commit的Pyright Hook中配置：

   - repo: https://github.com/RobertCraigie/pyright-python
     rev: v1.1.321
     hooks:
       - id: pyright
         additional_dependencies:
           - -r requirements-dev.txt
   

不过这种方式需要每次更新依赖后重新导出，容易遗漏，不如方案一便捷。

内容的提问来源于stack exchange，提问作者Aydin Abiar