PyCharm 新建 Python 文件时自动插入文件头依赖 File and Code Templates 中的 Python Script 模板，路径为 Settings/Preferences → Editor → File and Code Templates → Files → Python Script；模板变量须严格使用 ${NAME}、${USER}、${DATE} 等全大写带大括号格式，且仅通过右键 New → Python File 触发，其他方式无效。
PyCharm 新建 Python 文件时自动插入文件头，靠的是 File and Code Templates 里的 Python Script 模板，不是 Live Templates，也不是插件——配错位置就完全不生效。
怎么打开正确的模板配置页
很多人搜“PyCharm 文件头”点进 Live Templates 或 Editor → Inspections，结果白忙活。真正起作用的路径只有一条：
- Windows/Linux：点击
File → Settings → Editor → File and Code Templates → Files，再选中右侧的Python Script - macOS：点击
PyCharm → Preferences → Editor → File and Code Templates → Files → Python Script - 别点
Includes标签页——那是给模板里#parse("xxx")引用的片段用的，不是主模板 - 也别在
Code标签页下改——那是函数/类级代码补全，影响不到新建文件
模板里写什么？变量名必须带大括号
模板内容本质是纯文本，所有动态值都靠 ${xxx} 占位符替换。漏掉大括号或大小写错误，就会原样输出字符串，比如写成 $DATE 或 ${date}（正确是 ${DATE}）都会失效。
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
-
${NAME}→ 文件名（不含 .py），新建main.py时填入main -
${USER}→ 系统登录用户名，不是 PyCharm 账号，也不是 Git 用户名 -
${DATE}和${TIME}→ 生成时刻的值，每次新建文件都刷新，不是设置时的快照 -
${PROJECT_NAME}→ 当前打开的项目根目录名，如果没开项目（直接 Open Folder），这个变量为空 - 中文环境建议用
${MONTH_NAME_FULL}（如“七月”）而不是${MONTH}（如“07”），避免日期格式歧义
常见失效原因和绕过方案
配完发现新建文件没反应？大概率卡在这几个点上：
- 新建文件方式不对：必须用
Right-click project → New → Python File，用Ctrl+N新建空白文件不会触发模板 - 模板被覆盖：某些插件（如 Python AutoDocstring）或团队 shared templates 可能重置了
Python Script内容，检查右上角是否显示 “Inherited from shared templates” - 编码声明冲突：如果模板开头写了
# -*- coding: utf-8 -*-，但文件实际保存为 GBK，PyCharm 可能静默跳过整个模板解析——统一用 UTF-8 安全 - 变量拼写敏感：
${user}（小写）无效，${USER}（全大写）才有效；${time}不行，${TIME}才对
真正麻烦的不是设模板，而是团队协作时每个人模板不一致，或者变量值（比如 ${USER}）在 CI 环境里为空。这时候得靠预提交钩子校验头注释，而不是依赖 IDE 行为。
