# 示例：使用快捷鍵導航代碼
class DataProcessor:
    def __init__(self, config):  # Ctrl+B跳轉到定義
        self.config = config
    
    def process(self, data):  # Ctrl+F12查看方法列表
        cleaned = self._clean_data(data)  # Alt+Enter快速修復
        analyzed = self._analyze(cleaned)  # Ctrl+Alt+P提取參數
        return self._format(analyzed)  # Ctrl+Alt+V提取變量

# Ctrl+Shift+↑/↓: 移動代碼塊
# Ctrl+D: 複製行
# Ctrl+Y: 刪除行
# Ctrl+Shift+J: 合併行

# 示例：多光標操作
# 按住Alt+鼠標點擊 或 Alt+Shift+鼠標拖動創建多個光標
data = {
    "user_id": 12345,    # 多光標同時編輯
    "username": "john",  # 同時修改多個鍵值對
    "email": "john@example.com",
    "status": "active"
}

# 使用Ctrl+Shift+Alt+J選擇所有匹配項
def calculate(a, b, c):  # 同時修改多個參數
    return a * b + c

# 示例：利用智能補全
from dataclasses import dataclass

@dataclass
class User:  # 輸入"dataclass"後按Tab自動生成模板
    name: str
    age: int
    
# 類型感知補全
users: list[User] = []
for user in users:  # 輸入"user."會顯示User類的屬性
    print(user.)  # PyCharm會提示name, age等字段

# 使用Ctrl+Shift+Space獲取更具體的補全建議

# 自定義實時模板示例
# 設置路徑: File | Settings | Editor | Live Templates

# 自定義iter模板生成迭代代碼
# 縮寫: iter
# 模板文本:
for $item$ in $collection$:
    $END$
    
# 使用示例:
# 輸入"iter" + Tab → 自動生成for循環結構
data = [1, 2, 3]
for num in data:  # 自動生成的結構
    print(num)

# 示例：大型重構操作
class OrderService:
    def __init__(self, repository):
        self._repo = repository  # Shift+F6重命名變量
    
    # Ctrl+Alt+M提取方法
    def process_order(self, order):
        self._validate(order)  # 提取的驗證邏輯
        self._calculate(order)
        self._save(order)
    
    # Ctrl+Alt+P提取參數
    def _save(self, order, connection=None):
        connection = connection or get_default_conn()
        self._repo.save(order, connection)

# 配置代碼檢查規則
# 設置路徑: File | Settings | Editor | Inspections

# 示例：自定義Python檢查規則
def calculate_discount(price: float, discount: float) -> float:
    """計算折扣後的價格"""
    if discount > 1:  # PyCharm會警告折扣不應大於1
        raise ValueError("Invalid discount")
    
    return price * (1 - discount)  # 如果price不是float會有類型警告

# 使用Alt+Enter快速修復問題

# 示例：利用PyCharm的可視化調試工具
def merge_sort(data):
    if len(data) <= 1:  # 條件斷點: len(data) == 5
        return data
    
    mid = len(data) // 2
    left = merge_sort(data[:mid])  # 在Watches中添加"left"
    right = merge_sort(data[mid:])  # 在Variables視圖觀察變化
    
    # 使用"Evaluate Expression"(Alt+F8)計算data的哈希值
    return merge(left, right)  # 進入方法(F7)或跳過(F8)

# 調試控制枱可執行任意Python代碼

# 配置測試運行器優化
# 設置路徑: Run | Edit Configurations

# pytest.ini示例
[pytest]
addopts = --cache-clear -v --durations=10
python_files = test_*.py
norecursedirs = .* venv* __pycache__

# 使用Ctrl+R重新運行上次測試
# 使用Ctrl+Shift+R重新運行失敗測試
# 使用Ctrl+Shift+D調試上次測試

# 配置Code With Me協作
# 菜單: Git | Code With Me | Start Session

# 協作註釋示例
# TODO @alex: 需要優化這個算法的時間複雜度
def find_duplicates(items):
    seen = set()
    duplicates = []
    for item in items:
        if item in seen:  # @review: 考慮使用位圖?
            duplicates.append(item)
        seen.add(item)
    return duplicates

# 文檔字符串生成示例
def calculate_tax(income: float, brackets: list[tuple]) -> float:
    """計算累進税率下的應繳税額
    
    Args:
        income: 年收入(正數)
        brackets: 税率區間列表，如[(50000, 0.1), (100000, 0.2)]
        
    Returns:
        計算後的税額
        
    Raises:
        ValueError: 如果收入為負數
    """
    if income < 0:
        raise ValueError("收入不能為負數")
    # 輸入"""後按Enter自動生成文檔字符串模板

# 自定義項目模板
# 設置路徑: File | Settings | Editor | File and Code Templates

# Python腳本模板示例
# ${NAME}.py
#!/usr/bin/env python3
# -*- coding: utf-8 -*-

"""
${PROJECT_NAME} - ${DESCRIPTION}
Created on ${DATE}
@author: ${USER}
"""

import sys

def main():
    ${BODY}
    
if __name__ == '__main__':
    main()

# 錄製宏示例:
# 1. Edit | Macros | Start Macro Recording
# 2. 執行以下操作:
#    - 複製當前行(Ctrl+D)
#    - 移動到行尾(End)
#    - 添加註釋(# )
# 3. Edit | Macros | Stop Macro Recording
# 4. 分配快捷鍵Ctrl+Shift+C

# 使用宏快速創建測試用例
def test_addition():  # 使用宏快速複製並創建新測試
    assert add(1, 2) == 3
    
def test_subtraction():  # 自動生成的副本
    assert sub(5, 2) == 3