Modulenotfounderror: no module named distutils.cmd

In this article, we will discuss the solutions to solve the error no module named distutils.cmd which is experience of several python programmers.

Also read the other solve error: Modulenotfounderror no module named conf [SOLVED]

Why the modulenotfounderror no module named ‘distutils.cmd’ Occurs?

The modulenotfounderror no module named ‘distutils.cmd’ occurs if you run the python script without installing the “distutils” module in your python library.

However it is installed the distutils yet it’s installed in an incorrect PATH environment variable.

If you trying to import the distutils module then your python interpreter cannot find it on your system then you will get the ModuleNotFoundError.

For example you import like this:

 from distutils import distutils.cmd

Then the output will be following below:

ModuleNotFoundError: no module named distutils.cmd

Common reasons why this error may occur:

1. Missing module: The distutils.cmd module it should be missing from your Python library installation. This it will happen when you are using an older version of Python which is haven’t include in this module, or when the module was accidentally uninstall or removed.
2. Incorrect installation: When you have recently installed Python or a module that uses distutils.cmd, it is possible that the installation was not completed successfully or it does not installed in the correct path environment location.
3. Virtual environment issue: If you are running in a virtual environment, it is possible that the distutils.cmd module is haven’t installed in the virtual environment or it is installed in a different version of Python which is doesn’t used by the virtual environment.

How to solve the modulenotfounderror no module named ‘distutils.cmd’?

Other Solutions to solve the error

When the error “modulenotfounderror: no module named distutils.cmd,” still persists, your Python script should be using a different version of “distutils” rather than the one you are using.

To resolve this error, you need to uninstall the “distutils” module and reinstall it using “pip” command or “conda” command for the Python version your script is using. 

Solution 1: Uninstall the “distutils” module

Here is the following command to uninstall:

pip uninstall distutils

Solution 2: Reinstall the “distutils” module

Here is the example command to reinstall for the specific version:

pip install distutils==3.7

Diagnostic checklist for “No module named ‘distutils'”

• Verify pip install target. Run pip show distutils — if not installed, run pip install distutils.
• Check the active Python interpreter. which python (mac/Linux) or where python (Windows). Both pip and python must point to the same environment.
• Check virtual environment activation. If you use venv/conda, activate before installing: source .venv/bin/activate.
• Rule out uppercase/lowercase. Python imports are case-sensitive: import PyPDF2 not import pypdf2.
• Rule out the pip-vs-package-name mismatch. Some packages install under a different name than you import (e.g. pip install beautifulsoup4 → import bs4).

Installing distutils

# Standard pip install
pip install distutils

# In a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install distutils

# With uv (faster alternative)
uv pip install distutils

Common causes for “No module named ‘distutils'”

• Python interpreter mismatch. Multiple Python installations can confuse pip. Verify with which python and which pip.
• Virtual environment not activated. If the venv isn’t activated, pip installs to your system Python instead.
• Notebook kernel mismatch. Jupyter uses a kernel that may differ from your terminal Python. Use %pip install distutils inside the notebook.
• Import name differs from install name. pip install beautifulsoup4 → import bs4. Check the package’s PyPI page.
• Windows PATH issues. Ensure Python is on PATH; use python -m pip install to invoke pip via the correct Python.

Working code example

# Verify install worked
import distutils
print(getattr(distutils, '__version__', 'no version attribute'))

Best practices

• Always use a virtual environment. Avoids most module-not-found errors.
• Use pip freeze to lock versions. pip freeze > requirements.txt makes your setup reproducible.
• Consider uv or Poetry. Modern package managers with better dep resolution and reproducibility.

Conclusion

In conclusion, I hope one of these solutions above will help you resolve the “ModuleNotFoundError: no module named distutils.cmd” error.

Adones Evangelista

Programmer & Technical Writer at PIES IT Solution

Adones Evangelista is a programmer and writer at PIES IT Solution, author of over 900 tutorials and error-fix guides at itsourcecode.com. Specializes in JavaScript, Django, Laravel, and Python error debugging covering ValueError, TypeError, AttributeError, ModuleNotFoundError, and RuntimeError, plus C/C++ and PHP capstone projects for BSIT students.

Expertise: JavaScript · Python · Django · Laravel · Error Debugging · C/C++
 · View all posts by Adones Evangelista →