Neovim Kickstart中Pyright误报合法代码类型错误求助

一、解决合法代码的错误提示问题 #

你遇到的Pyright错误提示（如禁止None作为参数默认值、元组类型报错），是因为Pyright的部分严格检查选项在默认配置下仍会生效，即使设置了typeCheckingMode: basic。可以通过以下步骤解决：

1. 细化项目级pyrightconfig.json配置
   在项目根目录的pyrightconfig.json中添加严格检查的关闭选项：

   {
       "pythonVersion": "3.10.12",
       "pythonPlatform": "Linux",
       "typeCheckingMode": "basic",
       "strictParameterNoneDefault": false,
       "strictTupleInference": false
   }
   

   • strictParameterNoneDefault: 关闭后允许参数默认值为None（无需显式标注Optional类型）
   • strictTupleInference: 关闭后Pyright会宽松推断元组类型，不再强制要求显式标注固定长度的元组类型

2. 重启Pyright服务
   在Neovim中执行:LspRestart pyright命令，强制加载新配置。

3. 检查Kickstart配置的硬编码覆盖
   打开Kickstart的LSP配置文件（通常是lua/plugins/lsp.lua），确认pyright的setup部分没有硬编码覆盖配置文件的设置。如果存在类似以下代码，需要调整或移除：

   require('lspconfig').pyright.setup({
     settings = {
       pyright = {
         typeCheckingMode = "strict"
       }
     }
   })
   

二、全局Pyright配置方法 #

可以创建全局配置文件，避免逐个项目重复配置：

1. 创建全局配置文件

   • Linux/macOS：在用户目录下创建~/.config/pyrightconfig.json
   • Windows：创建%USERPROFILE%\.config\pyrightconfig.json或%APPDATA%\pyright\pyrightconfig.json

2. 写入全局默认配置
   将需要的默认配置写入该文件，示例：

   {
       "pythonVersion": "3.10.12",
       "pythonPlatform": "Linux",
       "typeCheckingMode": "basic",
       "strictParameterNoneDefault": false,
       "strictTupleInference": false
   }
   

   Pyright会优先读取项目级的pyrightconfig.json，项目未配置时自动使用全局配置。

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