基于Pyright的类型提示优化:Never与NoReturn的规范化处理
2025-07-07 16:45:21作者:尤辰城Agatha
在Python静态类型检查器Pyright的衍生项目BasedPyright中,开发团队发现了一个关于特殊类型Never的显示问题。当函数返回类型标注为Never时,IDE的悬停提示和嵌入提示中错误地将其显示为已弃用的NoReturn类型。
Never类型在Python类型系统中表示函数永远不会正常返回,通常用于抛出异常或无限循环的场景。该类型在Python 3.11+中成为标准,而旧名称NoReturn已被标记为弃用。基于Pyright作为现代类型检查工具,应当优先使用新的标准名称。
技术实现上,该问题源于类型评估器中对特殊类型的字符串表示处理。在类型评估阶段,当检测到Never类型时,系统错误地将其转换为NoReturn的字符串表示形式。这会导致IDE功能如代码提示和悬停信息显示不一致。
修复方案相对直接:修改类型评估器中相关代码段,确保Never类型在转换为字符串时保持原名。这一改动虽然微小,但对保持类型系统的一致性和现代性具有重要意义。
对于开发者而言,这一改进意味着:
- 更准确的类型提示信息
- 符合Python最新标准的开发体验
- 避免使用已弃用术语带来的混淆
该问题被标记为"good first issue",说明它是新贡献者熟悉项目代码库的良好切入点。修复过程不涉及复杂逻辑,主要考验开发者对项目架构和类型系统基础的理解。
基于Pyright团队通过这个案例展示了他们对细节的关注和对标准一致性的坚持,这也是该项目能够成为Python类型检查领域重要选择的原因之一。
登录后查看全文
热门项目推荐
相关项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0210
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0133
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
JoyAI-EchoJoyAI-Echo,这是一个独立的、仅用于推理的版本,旨在实现分钟级多镜头音视频生成。它采用了经过蒸馏的DMD生成器、配对的跨模态记忆以及故事级别的一致性。其性能的核心在于,一个跨模态视听记忆库能够在长达五分钟的视频中保持角色外观和语音音色的一致性。同时,一个训练后处理流程将基于记忆的强化学习与分布匹配蒸馏相结合,实现了7.5倍的速度提升,显著增强了视觉质量和对齐效果。00
wgai开箱即用的JAVAAI在线训练识别平台&OCR平台AI合集包含旦不仅限于(车牌识别、安全帽识别、抽烟识别、常用类物识别等) 图片和视频识别,可自主训练任意场景融合了AI图像识别opencv、yolo、ocr、esayAI内核识别;AI智能客服、AI语言模型、 无任何第三方API接口可定制化自主离线化部署并自主化行业化使用避免占用内存、GPU消耗训练与识别分开使用;Java06
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03
项目优选
收起
deepin linux kernel
C
32
16
暂无描述
Dockerfile
772
5.07 K
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。
C++
870
2 K
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
468
461
Ascend Extension for PyTorch
Python
749
938
本项目是CANN提供的神经网络类计算算子库,实现网络在NPU上加速计算。
C++
695
1.38 K
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
1.09 K
1.14 K
本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本,由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用,3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。
Dart
1.03 K
271
昇腾LLM分布式训练框架
Python
182
226
CANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体,本仓库为其提供可复用的 Skills 模块。
Python
1.03 K
641