本文对比 python 中字典初始化的两种主流方式——逐键赋值与字典字面量（含多行格式），阐明其在可读性、性能、维护性和工具兼容性上的差异，并推荐符合 pep 8 与工程实践的首选方案。
在 Python 开发中，尤其是处理配置数据、JSON 序列化或嵌套结构时，如何初始化字典是一个高频且影响代码质量的基础决策。开发者常面临两种写法的选择：一种是先创建空字典，再逐行赋值；另一种是直接使用字典字面量（{}）一次性声明。表面上看二者语义等价，但深入分析可见显著差异。
✅ 推荐方式：多行字典字面量（Dict Display）
Python 官方风格指南 PEP 8 明确建议：优先使用字面量语法而非构造函数或多次赋值。更关键的是，字面量完全支持优雅的多行格式，兼顾可读性与简洁性：
my_dict = {
'name': 'Alice',
'age': 32,
'active': True,
'roles': ['admin', 'editor'],
'metadata': {
'created_at': '2024-04-01',
'version': 2.1
}
}这种写法具有以下优势：
- 性能更优：字面量在编译期即构建完整对象，避免运行时多次哈希查找与内存分配；而 d[key] = value 每次调用均需键哈希、桶定位、冲突处理等开销。
- 原子性与安全性：字典一次性构造完成，不存在中间状态（如部分键已设、部分未设），避免因异常中断导致不一致。
- 静态分析友好：类型检查器（如 mypy）、IDE（PyCharm、VS Code）能更准确推断键名、类型和结构，提升自动补全与重构可靠性。
- 符合 Python 惯例：list, tuple, set, dict 均优先采用字面量；统一风格降低认知负荷。
⚠️ 显式逐键赋值的适用场景（有限）
my_dict = {}
my_dict['key1'] = compute_value_1()
my_dict['key2'] = compute_value_2() # 依赖 key1 的结果？
my_dict['key3'] = load_from_db() # 可能抛出异常仅当存在强顺序依赖（后续键值依赖前序计算结果）或动态/条件逻辑（如 if 分支决定是否插入某键）时，才应选用显式赋值。否则，它会带来冗余语法、更长行数、更差的 diff 可读性（Git 提交中单键变更将产生多行修改），且易引发 KeyError 风险（若误写 my_dict['key2'] 为 my_dict['kay2']）。
立即学习“Python免费学习笔记（深入）”；
? 关于 PyCharm 的提示说明
PyCharm 建议将多行显式赋值“折叠”为字面量，本质是识别到模式匹配（连续 d[k] = v），并基于上述工程优势发起优化建议。若你已采用多行字面量格式（如上例），PyCharm 不会再警告——这恰恰说明你的写法已符合最佳实践。无需强行压成单行（如 {'k1':'v1','k2':'v2'}），那反而违反可读性原则。
✅ 总结：一条清晰的实践准则
优先使用缩进对齐的多行字典字面量；仅在需要运行时动态/条件赋值时，才使用显式 dict[key] = value。 同时，配合 black 自动格式化工具，可确保字面量结构始终整洁一致，让团队协作与长期维护事半功倍。
