# 1. 安裝VS Code
# 官網：https://code.visualstudio.com/
# 2. 安裝Python
# 官網：https://www.python.org/downloads/
# Windows注意：安裝時勾選"Add Python to PATH"
# 3. 驗證安裝
python --version
# 輸出：Python 3.x.x
# 4. 在VS Code中安裝Python擴展
# 按 Ctrl+Shift+X，搜索"Python"，安裝Microsoft官方的Python擴展

// 在VS Code的settings.json中添加擴展推薦
{
  "recommendations": [
    "ms-python.python",                    // Python核心支持
    "ms-python.vscode-pylance",           // 智能補全
    "ms-python.black-formatter",          // 代碼格式化
    "ms-python.isort",                    // 導入排序
    "njpwerner.autodocstring",            // 自動生成文檔字符串
    "ms-toolsai.jupyter",                 // Jupyter筆記本支持
    "ms-toolsai.jupyter-keymap",          // Jupyter快捷鍵
    "donjayamanne.python-extension-pack", // Python擴展包
    "eamodio.gitlens",                    // Git增強
    "Gruntfuggly.todo-tree",              // TODO管理
    "VisualStudioExptTeam.vscodeintellicode" // AI輔助編碼
  ]
}

// .vscode/settings.json - 工作區(qū)配置
{
  // Python解釋器設置
  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/Scripts/python.exe",
  "python.terminal.activateEnvironment": true,
  // 代碼格式化
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.organizeImports": true
  },
  "python.formatting.provider": "black",
  "python.formatting.blackArgs": [
    "--line-length=88"
  ],
  "python.sortImports.args": [
    "--profile=black"
  ],
  // 代碼檢查
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.linting.flake8Enabled": true,
  "python.linting.mypyEnabled": true,
  "python.linting.pylintArgs": [
    "--load-plugins=pylint_django"
  ],
  // 測試配置
  "python.testing.pytestEnabled": true,
  "python.testing.unittestEnabled": false,
  "python.testing.pytestArgs": [
    "tests"
  ],
  // 文件排除
  "files.exclude": {
    "**/__pycache__": true,
    "**/.pytest_cache": true,
    "**/.mypy_cache": true,
    "**/.coverage": true
  },
  // 其他設置
  "python.analysis.autoImportCompletions": true,
  "python.analysis.typeCheckingMode": "basic",
  "files.autoSave": "afterDelay",
  "terminal.integrated.defaultProfile.windows": "Command Prompt"
}

// .vscode/launch.json - 調試配置
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: 當前文件",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": true
    },
    {
      "name": "Python: Django",
      "type": "python",
      "request": "launch",
      "program": "${workspaceFolder}/manage.py",
      "args": ["runserver"],
      "django": true
    },
    {
      "name": "Python: 測試",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "purpose": ["debug-test"],
      "console": "integratedTerminal"
    }
  ]
}

# 方法1：使用venv（Python內置，推薦）
python -m venv .venv
# 方法2：使用virtualenv（更靈活）
pip install virtualenv
virtualenv .venv
# 方法3：使用conda（數據科學常用）
conda create -n myenv python=3.9
conda activate myenv

# Windows
.venv\Scripts\activate
# Linux/Mac
source .venv/bin/activate
# 驗證是否激活
which python  # 應該顯示.venv路徑
pip list      # 應該只有基礎包

# pyproject.toml - 現代Python項目配置
[build-system]
requires = ["setuptools>=61.0", "wheel"]
build-backend = "setuptools.build_meta"
[project]
name = "my_project"
version = "0.1.0"
description = "我的Python項目"
readme = "README.md"
requires-python = ">=3.9"
dependencies = [
    "requests>=2.28.0",
    "pandas>=1.5.0",
    "numpy>=1.24.0",
]
[project.optional-dependencies]
dev = [
    "pytest>=7.0.0",
    "black>=23.0.0",
    "mypy>=1.0.0",
    "flake8>=6.0.0",
]
web = [
    "fastapi>=0.95.0",
    "uvicorn[standard]>=0.21.0",
]
[tool.black]
line-length = 88
target-version = ['py39']
[tool.isort]
profile = "black"
line_length = 88
[tool.mypy]
python_version = "3.9"
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
[tool.pytest.ini_options]
testpaths = ["tests"]
python_files = ["test_*.py"]
addopts = "-v --tb=short"

# requirements.txt - 傳統依賴文件
# 基礎依賴
requests==2.28.2
pandas==1.5.3
numpy==1.24.3
# 開發(fā)依賴
pytest==7.3.1
black==23.3.0
mypy==1.3.0
flake8==6.0.0
pre-commit==3.3.2
# 通過注釋分組
# 網絡框架
fastapi==0.95.2
uvicorn[standard]==0.21.1
# 數據庫
sqlalchemy==2.0.15
psycopg2-binary==2.9.6

# 安裝項目依賴
pip install -e .
# 安裝開發(fā)依賴
pip install -e ".[dev]"
# 生成requirements.txt
pip freeze > requirements.txt
# 從requirements.txt安裝
pip install -r requirements.txt
# 使用pip-tools管理版本
pip install pip-tools
pip-compile requirements.in  # 生成requirements.txt
pip-sync  # 同步環(huán)境

my_project/
├── .github/                    # GitHub配置
│   ├── workflows/              # CI/CD流水線
│   │   ├── test.yml
│   │   └── deploy.yml
│   └── ISSUE_TEMPLATE/         # Issue模板
├── .vscode/                    # VS Code配置
│   ├── settings.json
│   ├── launch.json
│   └── extensions.json
├── src/                        # 源代碼
│   └── my_package/
│       ├── __init__.py
│       ├── core.py
│       ├── utils.py
│       └── models/
│           ├── __init__.py
│           └── user.py
├── tests/                      # 測試代碼
│   ├── __init__.py
│   ├── test_core.py
│   ├── test_utils.py
│   └── conftest.py
├── docs/                       # 文檔
│   ├── index.md
│   ├── api/
│   └── examples/
├── scripts/                    # 腳本
│   ├── setup.py
│   ├── deploy.sh
│   └── backup.py
├── notebooks/                  # Jupyter筆記本
│   ├── 01-exploratory.ipynb
│   └── 02-analysis.ipynb
├── .env.example                # 環(huán)境變量示例
├── .gitignore                  # Git忽略文件
├── .pre-commit-config.yaml     # Git鉤子配置
├── pyproject.toml              # 項目配置
├── README.md                   # 項目說明
├── LICENSE                     # 許可證
├── Dockerfile                  # Docker配置
├── docker-compose.yml          # Docker編排
└── setup.py                    # 舊式打包配置

# .pre-commit-config.yaml - Git提交前檢查
repos:
  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.4.0
    hooks:
      - id: trailing-whitespace        # 刪除行尾空格
      - id: end-of-file-fixer          # 確保文件以換行結束
      - id: check-yaml                 # 檢查YAML語法
      - id: check-added-large-files    # 檢查大文件
      - id: check-ast                  # 檢查Python語法
      - id: check-merge-conflict       # 檢查合并沖突標記
      - id: debug-statements           # 檢查調試語句
  - repo: https://github.com/psf/black
    rev: 23.3.0
    hooks:
      - id: black
        language_version: python3.9
  - repo: https://github.com/pycqa/isort
    rev: 5.12.0
    hooks:
      - id: isort
        args: ["--profile", "black"]
  - repo: https://github.com/pycqa/flake8
    rev: 6.0.0
    hooks:
      - id: flake8
        additional_dependencies: [flake8-docstrings]
        args: ["--max-line-length=88", "--extend-ignore=E203,W503"]
  - repo: https://github.com/pre-commit/mirrors-mypy
    rev: v1.3.0
    hooks:
      - id: mypy
        additional_dependencies: [types-requests]
        args: [--ignore-missing-imports]

# tests/conftest.py - Pytest配置文件
import pytest
import sys
from pathlib import Path
# 添加src到Python路徑
sys.path.insert(0, str(Path(__file__).parent.parent / "src"))
# 全局fixture
@pytest.fixture(autouse=True)
def setup_test_env(monkeypatch):
    """為每個測試設置環(huán)境變量"""
    monkeypatch.setenv("TESTING", "True")
    monkeypatch.setenv("DATABASE_URL", "sqlite:///:memory:")
@pytest.fixture
def sample_data():
    """提供測試數據"""
    return {
        "name": "test",
        "value": 123
    }
# 自定義標記
def pytest_configure(config):
    config.addinivalue_line(
        "markers", "slow: 標記為慢速測試（需手動運行）"
    )
    config.addinivalue_line(
        "markers", "integration: 集成測試"
    )

# tests/test_example.py - 測試示例
import pytest
from my_package.core import add, divide
class TestMathFunctions:
    """數學函數測試"""
    def test_add_positive(self):
        """測試正數相加"""
        assert add(2, 3) == 5
        assert add(0, 0) == 0
    def test_add_negative(self):
        """測試負數相加"""
        assert add(-1, -1) == -2
    @pytest.mark.parametrize("a,b,expected", [
        (1, 2, 3),
        (10, 20, 30),
        (-5, 5, 0),
    ])
    def test_add_parametrized(self, a, b, expected):
        """參數化測試"""
        assert add(a, b) == expected
    def test_divide_by_zero(self):
        """測試除以零異常"""
        with pytest.raises(ValueError, match="除數不能為零"):
            divide(10, 0)
    @pytest.mark.slow
    def test_slow_operation(self):
        """慢速測試（標記為slow）"""
        result = slow_operation()
        assert result is not None
    @pytest.fixture
    def sample_list(self):
        """測試級別的fixture"""
        return [1, 2, 3, 4, 5]
    def test_with_fixture(self, sample_list):
        """使用fixture的測試"""
        assert len(sample_list) == 5
        assert 3 in sample_list

# scripts/setup.py - 項目設置腳本
#!/usr/bin/env python3
"""
項目初始化腳本
"""
import os
import sys
import subprocess
from pathlib import Path
import shutil
def run_command(cmd, cwd=None):
    """運行shell命令"""
    print(f"執(zhí)行: {cmd}")
    result = subprocess.run(cmd, shell=True, cwd=cwd, capture_output=True, text=True)
    if result.returncode != 0:
        print(f"錯誤: {result.stderr}")
        return False
    print(f"輸出: {result.stdout}")
    return True
def setup_project():
    """設置項目環(huán)境"""
    project_dir = Path(__file__).parent.parent
    # 1. 創(chuàng)建虛擬環(huán)境
    print("\n1. 創(chuàng)建虛擬環(huán)境...")
    if not (project_dir / ".venv").exists():
        if not run_command("python -m venv .venv", cwd=project_dir):
            return False
    # 2. 激活虛擬環(huán)境并安裝依賴
    print("\n2. 安裝依賴...")
    pip_path = project_dir / ".venv" / "Scripts" / "pip"
    if sys.platform != "win32":
        pip_path = project_dir / ".venv" / "bin" / "pip"
    if not run_command(f"{pip_path} install -e .[dev]"):
        return False
    # 3. 安裝pre-commit鉤子
    print("\n3. 設置Git鉤子...")
    if not run_command("pre-commit install"):
        return False
    # 4. 創(chuàng)建.env文件
    print("\n4. 創(chuàng)建環(huán)境變量文件...")
    env_example = project_dir / ".env.example"
    env_file = project_dir / ".env"
    if env_example.exists() and not env_file.exists():
        shutil.copy(env_example, env_file)
        print(f"已創(chuàng)建 .env 文件，請根據需求修改")
    print("\n? 項目設置完成！")
    print("下一步:")
    print("1. 編輯 .env 文件設置環(huán)境變量")
    print("2. 運行測試: pytest tests/")
    print("3. 啟動開發(fā)服務器: python -m my_package.main")
    return True
if __name__ == "__main__":
    if setup_project():
        sys.exit(0)
    else:
        sys.exit(1)

# Dockerfile
FROM python:3.9-slim
# 設置工作目錄
WORKDIR /app
# 設置環(huán)境變量
ENV PYTHONDONTWRITEBYTECODE=1 \
    PYTHONUNBUFFERED=1 \
    PIP_NO_CACHE_DIR=1
# 安裝系統依賴
RUN apt-get update && apt-get install -y \
    gcc \
    postgresql-client \
    && rm -rf /var/lib/apt/lists/*
# 復制依賴文件
COPY requirements.txt .
# 安裝Python依賴
RUN pip install --upgrade pip && \
    pip install -r requirements.txt
# 復制項目代碼
COPY . .
# 創(chuàng)建非root用戶
RUN useradd -m -u 1000 appuser && chown -R appuser:appuser /app
USER appuser
# 運行命令
CMD ["python", "src/my_package/main.py"]

# docker-compose.yml
version: '3.8'

services:
  web:
    build: .
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/mydb
    volumes:
      - .:/app
      - ./data:/data
    depends_on:
      - db
      - redis
    command: uvicorn src.my_package.main:app --host 0.0.0.0 --port 8000 --reload

  db:
    image: postgres:15
    environment:
      POSTGRES_DB: mydb
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

  pgadmin:
    image: dpage/pgadmin4
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@admin.com
      PGADMIN_DEFAULT_PASSWORD: admin
    ports:
      - "5050:80"
    depends_on:
      - db

volumes:
  postgres_data:

# scripts/profile.py - 性能分析腳本
import cProfile
import pstats
from pathlib import Path
def profile_code(func, *args, **kwargs):
    """
    分析函數性能
    參數:
        func: 要分析的函數
        *args, **kwargs: 函數參數
    """
    profiler = cProfile.Profile()
    profiler.enable()
    try:
        result = func(*args, **kwargs)
    finally:
        profiler.disable()
    # 輸出統計信息
    stats = pstats.Stats(profiler)
    stats.sort_stats(pstats.SortKey.TIME)
    print("\n" + "="*50)
    print("性能分析報告")
    print("="*50)
    # 打印前10個最耗時的函數
    stats.print_stats(10)
    # 保存到文件
    output_file = Path("profile_results.prof")
    stats.dump_stats(output_file)
    print(f"\n詳細結果已保存到: {output_file}")
    return result
# 使用示例
if __name__ == "__main__":
    def slow_function():
        total = 0
        for i in range(1000000):
            total += i
        return total
    result = profile_code(slow_function)
    print(f"結果: {result}")

#!/bin/bash
# 快速創(chuàng)建Python項目
# 使用方法: ./create_python_project.sh my_project
set -e  # 遇到錯誤立即退出
PROJECT_NAME=$1
if [ -z "$PROJECT_NAME" ]; then
    echo "用法: $0 <項目名>"
    exit 1
fi
echo "創(chuàng)建Python項目: $PROJECT_NAME"
# 創(chuàng)建項目目錄
mkdir -p "$PROJECT_NAME"
cd "$PROJECT_NAME"
# 創(chuàng)建目錄結構
mkdir -p src/"$PROJECT_NAME"
mkdir -p tests
mkdir -p docs
mkdir -p scripts
mkdir -p .github/workflows
mkdir -p .vscode
# 創(chuàng)建基礎文件
touch src/"$PROJECT_NAME"/__init__.py
touch tests/__init__.py
touch README.md
touch pyproject.toml
touch .gitignore
touch .env.example
touch .pre-commit-config.yaml
touch docker-compose.yml
touch Dockerfile
echo "# $PROJECT_NAME" > README.md
# 創(chuàng)建虛擬環(huán)境
python -m venv .venv
echo ""
echo "? 項目 '$PROJECT_NAME' 創(chuàng)建完成！"
echo ""
echo "下一步:"
echo "1. cd $PROJECT_NAME"
echo "2. source .venv/bin/activate  # Windows: .venv\Scripts\activate"
echo "3. 編輯 pyproject.toml 配置項目"
echo "4. pip install -e .[dev]"

# 1. VS Code找不到Python解釋器
# 按 Ctrl+Shift+P，輸入"Python: Select Interpreter"，選擇正確的解釋器
# 2. 導入錯誤（ModuleNotFoundError）
# 在項目根目錄添加 .env 文件，設置PYTHONPATH
# PYTHONPATH=src
# 3. 虛擬環(huán)境激活失敗
# Windows權限問題：以管理員運行PowerShell，執(zhí)行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 4. pip安裝慢
# 使用國內鏡像
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple package_name
# 5. 格式化不工作
# 檢查是否安裝了black，并在settings.json中配置正確