Python

totals = {
    row["category"]: row["amount"]
    for row in rows
    if row["active"]
}

推导式适合短而清晰的映射/过滤；复杂分支改用具名循环。

from pathlib import Path

text = Path("data/input.txt").read_text(encoding="utf-8")

pathlib 统一路径操作；文本边界显式指定编码。

try:
    payload = json.loads(raw)
except json.JSONDecodeError as exc:
    raise ValueError(f"invalid configuration: {exc.msg}") from exc

只捕获可以处理的具体异常，并用异常链保留根因。

# src/app/__main__.py
from .cli import main

if __name__ == "__main__":
    raise SystemExit(main())

使用 python -m app 运行，保持导入语义与安装后的包一致。

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "memory-tools"
version = "0.1.0"
requires-python = ">=3.12"

构建后端只是示例；团队应统一工具并提交锁文件（若所选工具支持）。

python -m venv .venv
# PowerShell
.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip

每个项目独立环境；在 CI 中从清单重建而不是复制 .venv。

python -m app --help

相比直接运行深层脚本，-m 能保持包内相对导入和模块边界。

python -m pip install build
python -m build

生成 wheel 与 source distribution；发布前在干净环境安装验证。

python -m pip install -e .

可编辑安装适合开发；依赖应在 pyproject 中声明而不是只存在于某台机器。

python -m pip check
python -m pip list --outdated

pip check 验证已安装依赖兼容性；升级前先看变更并运行完整测试。

import pytest

@pytest.mark.parametrize(("raw", "expected"), [("2", 2), (" 5 ", 5)])
def test_parse_count(raw: str, expected: int) -> None:
    assert parse_count(raw) == expected

正常值、边界、非法输入分别建例；断言面向行为而非内部实现。

python -m pytest -q
python -m pytest tests/test_core.py::test_parse_count -vv
python -m pytest --pdb

--pdb 在失败点进入调试器；CI 通常不启用交互模式。

logger.info("import completed", extra={"rows": count, "source": source})

日志记录事件和必要上下文，不记录密码、令牌或完整敏感数据。

确认当前 python 路径和虚拟环境 → python -m pip show 包名 → 使用 python -m app → 检查包布局和安装状态。

不要通过修改 sys.path 或复制文件长期掩盖包装问题。

def append_item(item: str, target: list[str] | None = None) -> list[str]:
    result = [] if target is None else target
    result.append(item)
    return result

默认参数在函数定义时只创建一次；用 None 表示每次新建。

确认 async 函数在事件循环中被 await；程序入口用 asyncio.run(main())，不要随意嵌套事件循环。

同步和异步边界应集中在入口层。

subprocess.run(
    ["git", "status", "--short"],
    check=True,
    text=True,
    capture_output=True,
)

参数使用列表；不要把不可信输入拼进 shell=True 字符串。

cursor.execute(
    "SELECT id, title FROM tasks WHERE owner_id = %s",
    (owner_id,),
)

占位符风格取决于数据库驱动；表名等标识符需要驱动提供的安全组合方式。

密钥放环境/密钥服务；不加载不可信 pickle；上传文件校验大小与类型；依赖定期升级和审计；日志脱敏。

不要提交 .env、虚拟环境、访问令牌或生产数据样本。