如何配置PyCharm外部工具？解决mypy类型检查环境变量未替换问题

Let’s walk through fixing this mypy setup issue— I’ve dealt with this exact hiccup before, so here’s how to get it sorted properly:

Why You’re Seeing That Error #

Your current setup has two key problems:

1. Incorrect target path: You’re pointing mypy to / (the system root directory), which obviously doesn’t contain your project’s Python files— hence the "no .py[i] files" error.
2. Unresolved environment variables: The <path-to-project> placeholder in your command isn’t being replaced with your actual project path, because you’re not using PyCharm’s built-in macros to dynamically pull these values.

Step-by-Step Correct Configuration #

1. Open External Tools settings:
   Go to File → Settings → Tools → External Tools (or PyCharm → Settings → Tools → External Tools on macOS). Click the + icon to create a new tool.

2. Fill in basic details:

   • Name: Give it a clear name like Mypy Type Check
   • Description: (Optional) Add a note like "Run static type checking with mypy"

3. Configure the Program path:
   Instead of hardcoding the venv path, use PyCharm’s macro to auto-detect your virtual environment’s mypy:

   $PyInterpreterDirectory$/mypy
   

   This will automatically point to venv/bin/mypy (Linux/macOS) or venv/Scripts/mypy.exe (Windows) as long as you’ve installed mypy in your project’s virtual environment.

4. Set up Arguments:
   Choose the right argument based on what you want to check:

   • Check the currently open file:

     --disallow-untyped-defs $FilePath$
     

   • Check the entire project:

     --disallow-untyped-defs $ProjectFileDir$
     

   The $FilePath$ and $ProjectFileDir$ macros dynamically insert the correct paths for your file or project root.

5. Set Working Directory:
   Use $ProjectFileDir$ here— this ensures mypy runs from your project root, so it can pick up any custom mypy.ini or pyproject.toml configuration you have.

6. Confirm Environment Variables:
   Click the Environment variables button in the bottom-right. Make sure the PYTHONPATH and other relevant variables are set to inherit from your project’s virtual environment (the default should work, but double-check if you’ve customized environments).

Verify the Setup #

• First, make sure mypy is installed in your venv: run pip install mypy in your project’s terminal.
• Test it out: Open a Python file, right-click → External Tools → Mypy Type Check. You should see the type checking results in PyCharm’s run console, without the "no .py[i] files" error.

Extra Tips #

• If you need additional mypy flags (like --ignore-missing-imports), just add them to the Arguments field, e.g.:

  --disallow-untyped-defs --ignore-missing-imports $FilePath$
  

• If you still see path issues, double-check your Python interpreter configuration: Go to File → Settings → Project: [Your Project Name] → Python Interpreter and confirm you’ve selected your project’s virtual environment.

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