【Python】VSCodeでLinterとFormatterが効かないときの対処方法

VSCodeの拡張機能としてFlake8とautopep8を導入したのですが、動作しませんでした。

今回はFlake8とautopep8が動作しなかった時の解決方法をお伝えします。

結論から言うと、LinterとFormatterが動作しなかった原因は仮想環境で使用したからでした。仮想環境をサブディレクトリに作成することで解決しました。

目次非表示

はじめに

仮想環境でPythonのコードを書いているときに、Microsoft公式のFlake8やautopep8を導入しましたが動作しないという問題が発生しました。

解決したので解決方法をお伝えします。

環境はWindows 11 Enterprise 24H2でPythonのバージョンは3.12.7です。

「venv」で仮想環境を作成してから、VSCodeの拡張機能としてFlake8とautopep8を追加しました。

追加後にVSCodeのワークスペース設定で以下のように設定をしたのですが、動作しませんでした。

VSCodeの右下の{ }をクリックすると、ログが表示されるので確認してみました。

対象のファイルのログには“Skipping standard library file”と記載されていました。

仮想環境内のプロジェクトのソースコードが標準ライブラリの一部であると思われてしまい、フォーマッターの機能がスキップされたみたいです。

フォーマッターが動作しないときは、以下のようなディレクトリ構成にしていました。

Libフォルダとpyvenv.cfgが存在するディレクトリにPythonのファイルを追加していました。この配置では動作しないみたいです。

Pythonのファイルが仮想環境内にあることがダメらしく、Libフォルダとpyvenv.cfgが同じディレクトに存在するとフォーマッターが効かないようです。

解決策としては、以下のコマンドで仮想環境を独自のサブディレクトリに作成することです。

cd my_project
py -m venv my_venv

ディレクトリ構成は以下のようになります。

プロジェクトフォルダ内のmy_venvフォルダ内にLibフォルダとpyvenv.cfgが存在する構成に変更して、別のsrcフォルダ内にPythonのソースファイルを入れました。

このディレクトリ構成でPythonファイルをVSCodeで開くと、無事にFlake8とautopep8が動作しました。

Flake8とautopep8がVSCodeの拡張機能で簡単に導入できると聞いて試してみましたが、動作しなかったので苦労しました

フォーマッターが動作しないという人は仮想環境のせいで効かないのかもしれないので、試してみてください。