[2026] Python Environment Setup | Install on Windows & Mac and Get Started

Introduction: Start coding in Python

Python is straightforward to install. You will walk through Windows and macOS (with Linux notes), pip, virtual environments, editors, and a sensible project layout so each project stays isolated—like giving every app its own toolbox instead of one global junk drawer. You will learn:

• Installing Python (official installer, Homebrew, pyenv overview)
• Python 3, and why 3.9+ is a good baseline
• pip, requirements.txt, Poetry
• Virtual environments: venv, virtualenv, conda
• Editors: VS Code, PyCharm
• Practical layout: src/, tests/, .gitignore
• Running your first program

---

Table of contents

1. Installing Python
2. Using pip
3. Virtual environments
4. VS Code
5. PyCharm
6. Project layout
7. Your first program
8. Summary

---

1. Installing Python

Windows

1. Download the latest Python 3 from python.org/downloads.
2. Run the installer.
3. Check “Add Python to PATH”—this is critical so python and pip work in the terminal.
4. Choose Install Now or customize paths if needed.
5. Verify:

python --version
pip --version

If Python is not on PATH, add the install and Scripts directories (e.g. ...\Python312\ and ...\Python312\Scripts\) under Environment Variables → Path, then open a new terminal.

macOS (Homebrew)

brew install python
python3 --version
pip3 --version

On macOS, python3/pip3 are common. Align versions with your team via pyenv or a pinned .python-version file.

Linux (Debian/Ubuntu)

다음은 간단한 bash 코드 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

sudo apt update
sudo apt install python3 python3-pip python3-venv
python3 --version
pip3 --version

Distro packages may lag; for servers, prefer venv per app and avoid global pip install when possible.

2. pip

pip installs packages from PyPI. 아래 코드는 bash를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

pip install requests
pip install requests==2.28.0
pip install --upgrade requests
pip uninstall requests
pip list
pip show requests

requirements.txt

pip freeze > requirements.txt
pip install -r requirements.txt

Example:

requests==2.28.0
flask==2.3.0
pandas==2.0.0

Poetry (optional)

Poetry manages dependencies and lockfiles via pyproject.toml / poetry.lock. Good for libraries and services when your team standardizes on it. 아래 코드는 bash를 사용한 구현 예제입니다. 에러 처리를 통해 안정성을 확보합니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

pip install poetry
poetry new my-package
cd my-package
poetry add requests
poetry install
poetry shell

---

3. Virtual environments

A virtual environment is an isolated Python environment per project (similar in spirit to node_modules). Why: Project A needs Django 3; project B needs Django 4—both can coexist.

Create and activate (venv)

아래 코드는 bash를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

# Windows
python -m venv venv
venv\Scripts\Activate.ps1
# macOS / Linux
python3 -m venv venv
source venv/bin/activate

When active, your prompt often shows (venv). Then pip install affects only this environment.

deactivate

Typical workflow

아래 코드는 bash를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

mkdir my_project && cd my_project
python -m venv venv
source venv/bin/activate   # or Windows activate script
pip install --upgrade pip
pip install flask requests
pip freeze > requirements.txt
deactivate

conda (Anaconda/Miniconda) is strong when you need non-Python binaries and scientific stacks aligned in one toolchain.

conda create -n myenv python=3.12
conda activate myenv

Rule of thumb: web and general apps → venv + pip; heavy data/GPU stacks → consider conda.

4. VS Code

1. Install from code.visualstudio.com.
2. Install the Python extension (Microsoft; Pylance often comes with it).
3. Python: Select Interpreter → choose ./venv/.../python. Recommended settings (excerpt): 아래 코드는 json를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

{
  "editor.formatOnSave": true,
  "python.terminal.activateEnvironment": true,
  "python.analysis.typeCheckingMode": "basic"
}

Install Black (or Ruff) in your venv for formatting.

5. PyCharm

PyCharm is a full IDE: refactoring, debugger, tests, DB tools. Community Edition is free. Create a project with a virtualenv or Poetry interpreter; Settings → Project → Python Interpreter matches VS Code’s interpreter choice.

6. Project layout

아래 코드는 text를 사용한 구현 예제입니다. 각 부분의 역할을 이해하면서 코드를 살펴보시기 바랍니다.

my_project/
├── src/
│   └── my_package/
│       ├── __init__.py
│       └── main.py
├── tests/
│   └── test_my_module.py
├── pyproject.toml
├── requirements.txt
├── README.md
├── .gitignore
└── venv/          # not committed

• src/: clear import roots; often used with editable installs (pip install -e .).
• tests/: run with pytest tests/.
• .gitignore: ignore venv/, __pycache__/, .env, IDE folders.

---

7. Your first program

REPL

python
>>> print("Hello, Python!")
>>> exit()

Script file

아래 코드는 python를 사용한 구현 예제입니다. 필요한 모듈을 import하고. 코드를 직접 실행해보면서 동작을 확인해보세요.

# hello.py
print("Hello, Python!")
import sys
print(sys.version)
name = "Alice"
print(f"Hello, {name}")

python hello.py

VS Code

Open hello.py, use Run Python File in Terminal or F5 for debugging. Set breakpoints in the gutter.

Tips and pitfalls

• Always prefer venv (or conda) over sudo pip install on system Python.
• Freeze dependencies when sharing: pip freeze > requirements.txt.
• Windows PowerShell: if activation fails, run Set-ExecutionPolicy RemoteSigned -Scope CurrentUser.
• SSL / proxy errors with pip: try --trusted-host for PyPI hosts, upgrade pip, or configure corporate proxy.

---

Troubleshooting (quick)

Issue	Idea
python not found	Reinstall with PATH, or use full path / py launcher on Windows
Permission denied on pip	Use a venv or pip install --user
Wrong packages after install	Activate the correct venv; check which python / where python
Broken venv	deactivate, delete venv, recreate, pip install -r requirements.txt

---

Hands-on examples

Simple calculator (calculator.py)

def add(a, b):
    """Add two numbers."""
    return a + b
def subtract(a, b):
    return a - b
def multiply(a, b):
    return a * b
def divide(a, b):
    if b == 0:
        return "Error: division by zero"
    return a / b
def main():
    print("=" * 40)
    print("Simple calculator")
    print("=" * 40)
    num1 = float(input("First number: "))
    op = input("Operator (+, -, *, /): ")
    num2 = float(input("Second number: "))
    if op == "+":
        result = add(num1, num2)
    elif op == "-":
        result = subtract(num1, num2)
    elif op == "*":
        result = multiply(num1, num2)
    elif op == "/":
        result = divide(num1, num2)
    else:
        result = "Invalid operator"
    print(f"\nResult: {num1} {op} {num2} = {result}")
if __name__ == "__main__":
    main()

Sample .gitignore

아래 코드는 text를 사용한 구현 예제입니다. 코드를 직접 실행해보면서 동작을 확인해보세요.

venv/
.venv/
__pycache__/
*.pyc
.env
.idea/

---

Advanced pointers

• pyenv: install and switch multiple Python versions per project.
• Docker: FROM python:3.12-slim, COPY requirements.txt, RUN pip install -r requirements.txt.
• CI: GitHub Actions actions/setup-python with a matrix of Python versions.

---

Summary

1. Install Python 3 from python.org or a package manager; ensure PATH on Windows.
2. Use pip + requirements.txt; consider Poetry for stricter workflows.
3. Use python -m venv and activate before installing packages.
4. Use VS Code or PyCharm with the interpreter pointing at your venv.
5. Structure repos with src/, tests/, .gitignore.

Next steps

• Python basics: variables, operators, control flow
• Python data types: list, dict, tuple, set
• Python functions

---

Official resources

• Python docs
• pip documentation
• venv
• PEP 8

---

Related posts

• Python syntax
• Python data types
• Python modules (when available in English)