Mypy Type Checker 2025.3.11071011

Mypy类型检查器：Visual Studio Code扩展版，提升Python开发效率

Mypy类型检查器的Visual Studio Code扩展版，为Python开发者提供了一个强大且灵活的类型检查工具。该扩展支持Mypy 1.15.0及以上版本，适用于所有当前支持的Python语言版本。

核心功能：

• 集成类型检查：安装扩展后，打开Python文件时Mypy会自动执行，并在“问题”窗口中报告任何错误或警告。
• 自定义Mypy版本：默认使用扩展自带的Mypy版本，但您可以通过设置mypy-type-checker.importStrategy使用环境中的不同版本，或通过mypy-type-checker.path设置使用自定义Mypy可执行文件。
• 工作区范围检查：默认情况下，扩展仅对编辑器中打开的文件报告错误和警告，但您可以通过设置mypy-type-checker.reportingScope对整个工作区进行检查。
• 单一仓库支持：如果您在使用单一仓库，可以通过设置mypy-type-checker.cwd为${fileDirname}，让扩展为工作区根文件夹下的子文件夹中的Python文件提供类型检查。您还可以通过mypy-type-checker.ignorePatterns设置忽略/跳过特定文件或文件夹路径的类型检查。
• 自定义linting规则：通过mypy-type-checker.severity设置，您可以自定义特定Mypy错误代码的严重性。
• Mypy守护进程支持：当报告范围设置为整个工作区时，扩展支持Mypy守护进程（dmypy）以加快类型检查速度。通过设置mypy-type-checker.preferDaemon为true来启用它。

禁用Mypy：

您可以通过设置mypy-type-checker.ignorePatterns来跳过特定文件或目录的类型检查。如果您希望禁用整个工作区或全局的Mypy，可以在Visual Studio Code中禁用此扩展。

设置选项：

扩展提供了多种设置选项，允许您自定义其行为。以下是一些关键设置：

• mypy-type-checker.args：传递给Mypy的参数，用于启用Python文件的类型检查。
• mypy-type-checker.cwd：设置用于lint Python文件的当前工作目录。
• mypy-type-checker.severity：映射Mypy的消息类型到VS Code的诊断严重性级别。
• mypy-type-checker.path：扩展用于类型检查Python文件的路径或命令。
• mypy-type-checker.interpreter：用于启动Mypy服务器和任何子进程的Python可执行文件或命令的路径。
• mypy-type-checker.importStrategy：定义用于类型检查Python文件的Mypy二进制文件。
• mypy-type-checker.showNotifications：控制何时显示通知。
• mypy-type-checker.reportingScope：控制Mypy的问题报告范围。
• mypy-type-checker.preferDaemon：是否优先使用Mypy守护进程（dmypy）进行类型检查。
• mypy-type-checker.daemonStatusFile：Mypy守护进程（dmypy）使用的状态文件路径。
• mypy-type-checker.ignorePatterns：配置glob模式以排除Mypy类型检查的文件或文件夹。

命令：

• Mypy: Restart Server：强制重启linter服务器。

日志记录：

通过命令面板（视图 > 命令面板...）运行开发者：设置日志级别...命令。选择Mypy类型检查器并设置所需的日志级别。您还可以通过设置mypy-type-checker.trace.server为verbose获取更详细的Mypy服务器日志。

故障排除：

如果mypy-type-checker.importStrategy设置为fromEnvironment但在选定环境中未找到Mypy，扩展将回退到使用扩展自带的Mypy二进制文件。如果环境中安装了依赖项，这些依赖项将与自带的Mypy二进制文件一起使用，这可能导致兼容性问题。

解决此问题的方法包括：

• 将mypy-type-checker.importStrategy设置为useBundled，并将mypy-type-checker.path设置为指向您想要使用的自定义Mypy二进制文件；或
• 在选定环境中安装Mypy。

如果将报告范围设置为workspace并注意到类型检查速度变慢，您可以尝试通过将mypy-type-checker.preferDaemon设置为true来启用Mypy守护进程（dmypy）。