はじめに

CursorでPython開発をしていたところ、補完や定義ジャンプは正常に動作しているにもかかわらず、クラス名や型名だけシンタックスハイライトが効かない現象に遭遇しました。

最初はPython拡張やPyrightの不具合を疑いましたが、最終的には pyproject.toml の設定を見直すことで解決できました。

1. 発生した問題

例えば次のコードを開いたとき、

from pathlib import Path

p = Path("sample")

from や import には色が付くのに、Path や p が灰色のままになっていました。

しかし、

という状態でした。

さらに観察すると、問題のプロジェクトでしばらく待つと色が付きました。

原因としては、Pyrightの解析対象が広く、
セマンティックトークンの生成に時間がかかっていた可能性が高そうでした。
そこで pyproject.toml を見直し、解析対象を限定しました。

[tool.pyright]
exclude = [
    ".venv",
    "__pycache__",
    "build",
    "dist"
]

pyrightconfig.jsonを編集でもいいらしいです。

pyrightconfig.json

{
  "exclude": [
    ".venv",
    "**/__pycache__",
    "build",
    "dist"
  ]
}

設定変更後は、

などに即座に色が付くようになりました。

起動直後に長時間待たされることもなくなり、補完や型解析も快適になりました。