Setting up a Development Environment on Linux for Python

Install Python and essential tools using your distribution’s package manager, ensuring python3-venv and python3-dev are included for environment isolation and C extensions. 2. Always use virtual environments by running python3 -m venv myproject_env and activate with source myproject_env/bin/activate to isolate dependencies. 3. Upgrade pip, setuptools, and wheel in each environment and manage project packages via pip install, saving them with pip freeze > requirements.txt for reproducibility. 4. Choose a code editor like VS Code (install via sudo snap install --classic code and add the Python extension) or PyCharm for full IDE support. 5. Optionally, use pyenv to manage multiple Python versions by installing it via curl https://pyenv.run | bash, configuring shell paths, then installing and setting versions with pyenv install and pyenv global. 6. Enhance development with tools like Black, isort, ruff, and pytest installed via pip, and integrate them into your workflow for formatting, import sorting, linting, and testing—ensuring a clean, maintainable, and professional-grade Python environment on Linux.

Setting up a Python development environment on Linux is straightforward, but doing it right ensures you avoid dependency conflicts and have a clean, maintainable setup. Here’s how to do it properly.

1. Install Python and Essential Tools

Most Linux distributions come with Python pre-installed, but it's best to use a recent version. Start by checking your current version:

python3 --version

If you're on an older version or don't have it, install the latest Python from your distribution's package manager.

On Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip python3-venv python3-dev

On Fedora/RHEL:

sudo dnf install python3 python3-pip python3-venv python3-devel

On Arch Linux:

sudo pacman -S python python-pip

Also install build-essential (Ubuntu) or equivalent to compile packages:

sudo apt install build-essential  # Ubuntu/Debian

python3-venv is critical for creating isolated environments. python3-dev is needed for some C extensions in packages like numpy or psycopg2.

2. Use Virtual Environments

Never install packages globally. Always use virtual environments to isolate project dependencies.

Create a virtual environment:

python3 -m venv myproject_env

Activate it:

source myproject_env/bin/activate

You’ll see (myproject_env) in your shell prompt. Now any pip install goes into this environment only.

To deactivate:

deactivate

Pro tip: Name your environment .venv and add it to .gitignore — it's a common convention.

3. Install and Use pip, setuptools, and wheel

Make sure pip is up to date:

pip install --upgrade pip

These tools help install and package Python projects:

• pip: installs packages
• setuptools: builds packages
• wheel: installs pre-built packages efficiently

Install them in your activated environment:

pip install --upgrade pip setuptools wheel

Now you can install packages like:

pip install requests django flask numpy

Use a requirements.txt file to save dependencies:

pip freeze > requirements.txt

And to restore them on another machine:

pip install -r requirements.txt

4. Choose a Code Editor or IDE

Popular choices on Linux:

• VS Code – Lightweight, great Python support via extensions (like Pylance, Python extension by Microsoft).
• PyCharm – Full-featured IDE (Community Edition is free).
• Vim/Neovim or Emacs – For terminal lovers, with plugins for linting, autocompletion.
• Sublime Text or Atom – Fast and customizable.

For VS Code:

sudo snap install --classic code

Then install the official Python extension for debugging, linting, and IntelliSense.

5. Optional: Use pyenv for Managing Python Versions

If you need multiple Python versions (e.g., 3.9, 3.11, 3.12), use pyenv.

Install pyenv:

curl https://pyenv.run | bash

Add to your shell config (~/.bashrc or ~/.zshrc):

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

Reload your shell:

source ~/.bashrc

Install and set a Python version:

pyenv install 3.11.0
pyenv global 3.11.0  # or `pyenv local 3.11.0` for per-project

Now python points to the version managed by pyenv.

6. Install Useful Development Tools

Enhance your workflow with these tools:

• Black – Code formatter
• isort – Sorts imports
• flake8 or ruff – Linter
• pytest – Testing framework

Install them in your virtual environment:

pip install black isort ruff pytest

Use them:

black .
ruff check .
pytest

You can integrate these into your editor or use them in pre-commit hooks.

That’s it. You now have a solid, professional-grade Python development setup on Linux. Use virtual environments religiously, keep your tools updated, and automate linting and formatting early.

Basically: install Python, use venv, manage packages with pip, pick a good editor, and consider pyenv if you juggle versions. Not flashy, but rock solid.

The above is the detailed content of Setting up a Development Environment on Linux for Python. For more information, please follow other related articles on the PHP Chinese website!