微软给 VS Code 推的 Pylance 确实让 Python 类型提示好用了不少但真到项目里很多人把python.analysis.typeCheckingMode从off改成basic或strict.py文件里还是看不到该有的红线。这个排障场景里TaoToken 只做一件事给 Codex 一条兼容接入通道。先去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建 API Key再把 Codex 的 Base URL 填成 https://taotoken.net/api然后让 Codex 对照 Pylance 的“类型检查”“代码诊断”段落检查.pyi文件和settings.json里的开关定位为什么不提示。下面按排障顺序走先看 Pylance 的诊断链路再配 Codex再用最小文件验证最后处理通道和诊断级别的常见错。1. Pylance 开了 basic 仍不画红线先看诊断链路断在哪1.1 typeCheckingMode 不是唯一开关Pylance 默认的python.analysis.typeCheckingMode是off这是很多人第一反应要去改的地方。原文让你在设置里搜到这一项改成basic或strict思路没错但它只决定“类型检查规则开到什么程度”不决定“诊断有没有被送到编辑器里”。真正影响红线的还有几个位置python.analysis.diagnosticMode控制检查范围默认常见值是openFilesOnly意思是只检查当前打开的文件如果项目里有pyrightconfig.jsonPylance 会优先采用里面的typeCheckingMode工作区.vscode/settings.json也会覆盖用户级settings.json。你在 UI 里看到的是basic不代表实际生效的配置就是basic。还有一种更隐蔽的情况文件本身没有被 Pylance 纳入分析。比如python.analysis.exclude写了排除规则或者当前 Python 解释器没选中Pylance 没法建立索引。此时编辑器看起来“安装了 Pylance”但类型诊断链路根本没跑起来。排查时不能只盯typeCheckingMode一个值要把设置来源、诊断范围、文件索引状态一起看。1.2 settings.json、pyrightconfig.json、.pyi 三层覆盖第一层是用户settings.json路径通常在%APPDATA%\Code\User\settings.json或~/.config/Code/User/settings.json。第二层是工作区.vscode/settings.json它只对当前项目生效但优先级更高。第三层是pyrightconfig.json或pyproject.toml里的[tool.pyright]这层最容易被忽略因为改完 VS Code 设置后项目里的 pyright 配置可能又把值拉回去了。再往下还有.pyi存根文件。Pylance 的类型推断会参考存根如果某个库的.pyi把参数写成Any或者本地存根覆盖了原本更精确的类型那么调用处就不会出现你预期的参数类型错误。看起来像 Pylance 不提示实际上是类型已经被放宽。可以先让 Codex 生成一组本地检查命令由你在项目根目录执行再把输出贴回对话。比如下面这类命令不要直接让 Codex 去改文件先让它列出所有可能影响 Pylance 的配置rg -n typeCheckingMode|diagnosticMode|diagnosticSeverityOverrides|pyrightconfig|tool\\.pyright|python.analysis.exclude . rg --files -g *.pyi -g pyrightconfig.json -g pyproject.toml -g settings.jsonWindows 里没有rg也可以用 PowerShellGet-ChildItem -Recurse -Include *.pyi,pyrightconfig.json,pyproject.toml,settings.json | Select-String -Pattern typeCheckingMode|diagnosticMode|diagnosticSeverityOverrides|tool.pyright|python.analysis.exclude这些命令只读文件不碰生产库也不执行你的业务代码。把结果贴给 Codex让它对照 Pylance 的配置项逐条判断比自己在设置面板里来回试要快。2. 把 Codex 的 Base URL 指到 https://taotoken.net/api2.1 去官网创建 YOUR_API_KEY别把落地页和 Base URL 混用先打开 TaoToken 官网注册并创建 API Key。这个 Key 后面用占位符YOUR_API_KEY表示不要把它写进博客、截图或提交到 Git。官网落地页是给人点的用于注册、创建 Key、看模型广场、看用量填进 Codex 的 Base URL 是另一回事固定写https://taotoken.net/api末尾不要加/v1也不要带任何 UTM 查询参数。模型 ID 不要猜。不要写gpt-5、不要随手加日期后缀去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 的模型广场复制当时可用的模型 ID。Codex 配置里先用YOUR_MODEL_ID占位等从模型广场拿到准确名称后再替换。Base URL 和模型 ID 都填错时表现可能是 404 或模型不存在不是 Pylance 的问题。2.2 ~/.codex/config.toml 的 model_provider 和 base_url 写法Codex 的配置文件是~/.codex/config.tomlWindows 下通常在C:\Users\你的用户名\.codex\config.toml。把 provider 指向自定义兼容通道base_url填 TaoToken 的 API 地址不要套用 Claude Code 的ANTHROPIC_*环境变量。# ~/.codex/config.toml model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chatKey 通过环境变量传进去。macOS 或 Linux 的 shell 里可以这样临时设置export TAOTOKEN_API_KEYYOUR_API_KEY codexWindows PowerShell 里用$env:TAOTOKEN_API_KEYYOUR_API_KEY codex这里有两个容易写错的位置base_url不要写成https://taotoken.net/api/v1配置里也不要带?utm_source...。Codex 拿到的只是接口地址和 KeyUTM 参数是给网页统计用的混进 API 地址只会让请求路径变奇怪。2.3 启动 Codex 后先问一个能验证通道的问题保存config.toml和环境变量后在项目根目录启动codex。先不要一上来就让它改 Pylance 配置先发一个能验证通道和文件读取范围的问题请用一句话确认你能收到请求。 然后只读当前项目里的 .vscode/settings.json、pyproject.toml、pyrightconfig.json 列出所有可能影响 Pylance 类型检查的配置项并给出我在本地执行的检查命令。 不要直接修改文件也不要执行任何业务代码。如果 Codex 能正常回答说明 Base URL 和 Key 已经通了。它返回的检查命令由你在本地终端执行把输出再贴回对话。这样 Codex 负责对照 Pylance 的类型检查和代码诊断规则你负责在本地读取真实项目状态双方分工清楚。如果这里直接报 401先检查 Key 是不是从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建的那把环境变量名是否和env_key一致。如果报 404优先检查base_url是不是误加了/v1或 UTM 参数。通道问题解决之前不要继续折腾 Pylance 设置。3. 让 Codex 对照 Pylance 的“类型检查”“代码诊断”逐项排查3.1 给 Codex 的排查提示词要带文件内容和最小复现代码Codex 不是靠猜来定位 Pylance 问题的你需要把关键上下文给它工作区settings.json内容、pyproject.toml里[tool.pyright]片段、pyrightconfig.json内容、以及一段最小复现代码。可以这样组织提示词我正在排查 VS Code 中 Pylance 类型检查不提示的问题。 已确认 python.analysis.typeCheckingMode 在用户设置里改成了 basic但 .py 文件没有预期红线。 请对照 Pylance 的“类型检查”和“代码诊断”配置帮我检查 1. 工作区 .vscode/settings.json 和用户 settings.json 是否有冲突 2. pyrightconfig.json 或 pyproject.toml 的 [tool.pyright] 是否覆盖了 typeCheckingMode 3. diagnosticMode 是否为 openFilesOnly 4. python.analysis.exclude 是否排除了当前文件 5. diagnosticSeverityOverrides 是否把某些规则改成了 none 6. 项目内 *.pyi 是否把关键参数写成了 Any。 下面是相关文件内容和最小复现代码 ...提示词里明确“不要直接执行我的业务代码”“只生成检查命令”。读者在本地执行后把输出贴回去。这样既能让 Codex 参与排障又不会把它当成能直接连生产环境的执行器。3.2 settings.json 里三个开关的对照表Pylance 的类型检查不提示最常见的是下面几个键没有形成合力。先看它们的实际值再看优先级。配置项常见值不提示时怎么查python.analysis.typeCheckingModeoff、basic、strict工作区设置可能覆盖用户设置pyrightconfig.json又可能覆盖工作区python.analysis.diagnosticModeopenFilesOnly、workspace只检查打开文件时未打开文件不会出现诊断python.analysis.diagnosticSeverityOverrides规则名到error、warning、none某条规则被写成none对应类型错误就不会画红线python.analysis.excludeglob 数组当前文件或目录被排除后Pylance 不分析python.analysis.ignoreglob 数组与 exclude 类似诊断会被跳过一个能让多数基础类型错误显形的settings.json片段如下。注意 JSON 里不能写注释规则名以你当前 Pylance 版本实际支持为准{ python.analysis.typeCheckingMode: basic, python.analysis.diagnosticMode: workspace, python.analysis.diagnosticSeverityOverrides: { reportGeneralTypeIssues: error, reportArgumentType: error, reportAssignmentType: error } }如果项目根目录还有pyrightconfig.jsonPylance 可能优先采用它。一个常见覆盖写法是{ typeCheckingMode: basic, diagnosticMode: workspace, include: [src], exclude: [**/node_modules, **/.venv] }排查时把这两个文件一起贴给 Codex让它判断谁盖住了谁。只改 VS Code 设置、不看pyrightconfig.json很容易出现“设置里明明是 basic实际诊断仍被压掉”的情况。3.3 .pyi 存根和 pyrightconfig.json 的覆盖关系.pyi存根的影响经常被低估。Pylance 对第三方库的类型推断会优先看类型存根如果本地或依赖包里存在同名.pyi里面把函数参数写成Any那么调用处传错类型也不会报。排查时先让 Codex 生成搜索命令找出项目中所有.pyi以及可能影响 pyright 的配置文件rg --files -g *.pyi rg -n Any --glob *.pyiPowerShell 下可以Get-ChildItem -Recurse -Filter *.pyi | Select-String -Pattern Any把结果贴回 Codex让它判断哪些存根可能把类型放宽了。另一个覆盖源头是pyproject.toml[tool.pyright] typeCheckingMode basic diagnosticMode workspace include [src]如果这个片段存在Pylance 会把它当成项目级配置。你在 VS Code 设置里改的值不一定生效。让 Codex 对照“类型检查”“代码诊断”两段规则逐项确认优先级比手动猜要可靠。4. 一条可复现的验证路径从 Pylance 红线到 TaoToken 用量4.1 最小 Python 文件验证 basic/strict 是否生效先不要拿复杂业务文件试。新建一个pylance_check.py写一段确定会触发类型错误的代码from typing import Optional def greet(name: str) - str: return hello name maybe_name: Optional[str] None print(greet(maybe_name))当typeCheckingMode为basic或strict并且diagnosticMode覆盖当前文件时greet(maybe_name)这一行应该出现参数类型不匹配的诊断。Pylance 通常会提示类似“str | None不能赋给str”的问题。如果没有红线把这段代码、settings.json、pyrightconfig.json和.pyi搜索结果一起贴给 Codex。这一步的关键是隔离变量先证明 Pylance 对最小文件有没有诊断再去看复杂项目。如果最小文件有红线说明类型检查开关至少生效了问题可能在项目排除规则或存根如果最小文件也没有优先查typeCheckingMode、diagnosticMode和工作区覆盖。4.2 本地执行 Codex 生成的检查命令把输出贴回去Codex 给出的命令不要让它自己执行。你在本地终端跑把输出复制回对话。可以要求 Codex 按这个格式输出检查清单1. 输出当前生效的 Pylance 相关设置来源 2. 输出 pyrightconfig.json 与 pyproject.toml 的覆盖关系 3. 输出项目中可能影响类型推断的 .pyi 文件 4. 输出最小复现代码的预期诊断 5. 给出下一步只读检查命令。你执行后把终端输出贴回。Codex 再根据真实输出判断是diagnosticSeverityOverrides把规则改成了none还是exclude排除了文件还是.pyi把参数写成了Any。这个过程仍然只是生成、解释、对照配置真正的文件修改由你确认后再做。4.3 在控制台看这次 Codex 调用有没有记上账Codex 能正常回答后回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 的控制台看一下这次调用的用量。这一步不是形式主义如果控制台没有记录说明 Codex 可能还在走旧的 provider或者环境变量没有生效只是看起来回答成功。确认 Key、Base URL、模型 ID 三者一致后再继续 Pylance 排查。如果用量正常说明 Codex 已经通过https://taotoken.net/api这条兼容通道在工作。接下来你可以反复用同一把 Key 发排查请求让它对照 Pylance 的类型检查、代码诊断、.pyi存根和settings.json覆盖关系直到最小文件出现预期红线。5. 还不出红线时的排障分支401、404、模型 ID 与诊断级别5.1 Codex 通道侧的错401、404、多了 /v1Codex 侧最常见的错是 401 和 404。401 通常表示 Key 没传进去或者环境变量名和config.toml里的env_key不一致。检查TAOTOKEN_API_KEY是否已经导出Windows 下新开的终端是否会丢失临时环境变量。Key 本身从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建不要拿旧 Key 反复试。404 优先查base_url。Codex 配置里应写base_url https://taotoken.net/api不要写成https://taotoken.net/api/v1也不要附加?utm_source...。如果返回模型不存在去模型广场复制准确的模型 ID替换YOUR_MODEL_ID。通道错误和 Pylance 配置错误会混在一起先让 Codex 用一句简单问答确认通道再继续排查类型提示。5.2 Pylance 侧的错诊断级别被 none、exclude、type ignore 吃掉通道通了、最小文件仍没红线时重点查 Pylance 侧。第一看diagnosticSeverityOverrides里有没有把关键规则改成none第二看python.analysis.exclude或python.analysis.ignore是否排除了当前文件第三看文件里有没有大范围# type: ignore或# pyright: ignore第四看diagnosticMode是不是仍停留在openFilesOnly导致未打开文件不报第五看.pyi是否把参数写成了Any。把这些内容交给 Codex 时让它逐条对照“类型检查”和“代码诊断”段落不要只给结论。它应该输出“哪一行配置覆盖了哪一项规则”“为什么这个参数不会触发红线”“本地要执行什么命令确认”。你执行命令把输出贴回再决定改哪个文件。5.3 下一步模型对话、Coding Plan 与创建 KeyPylance 红线出来之后建议先用同一把 Key 在 TaoToken 模型对话 发一条测试消息确认模型 ID 和 Base URL 在对话通道里也正常。如果打算长期让 Codex 帮你排查项目配置可以打开 Coding Plan 看用量是否够用需要重新创建或轮换 Key去 控制台 API Keys 操作。下次再遇到settings.json、pyrightconfig.json和.pyi三方打架先让 Codex 列出覆盖关系再在本地执行验证命令不用再对着设置面板盲试。