PyCharm新建.py文件自动添加头部注释依赖「文件模板」机制，需通过File→Settings→Editor→File and Code Templates→Python Script路径配置，使用${NAME}、${USER}、${DATE}、${TIME}等标准变量，且必须严格按${VAR}格式书写，仅当通过New→Python File创建时生效。
PyCharm 新建 .py 文件时自动插入头部注释，靠的是「文件模板」机制，不是插件也不是快捷键——改对位置、用对变量，一次配置，永久生效。
怎么打开 Python Script 模板编辑页
别在设置里搜“注释”或“header”，直接走标准路径：
File → Settings（Windows/Linux）或 PyCharm → Preferences（macOS），然后逐级展开：Editor → File and Code Templates → Python Script。
这个 Python Script 模板就是新建 .py 文件时的源头，改它，所有新文件都跟着变。
模板里哪些变量能用、怎么写才不翻车
变量必须严格写成 ${NAME} 格式，多一个空格、少一个大括号都不替换。常见有效变量有：
-
${DATE}和${TIME}：生成形如2026/07/31和15:47:22的字符串，注意大小写敏感 -
${USER}：取系统登录用户名，不是 Git 用户名，也不是 PyCharm 账号名 -
${NAME}：新建文件时你输入的文件名（不含.py），比如填main，就输出main -
${PROJECT_NAME}：仅当项目已打开且有合法项目名时才有效，否则留空 -
${PRODUCT_NAME}：固定输出PyCharm，不是IntelliJ IDEA
错误写法示例：$USER、${user}、${ name } —— 全部失效，原样留在文件里。
为什么新建文件没看到注释？三个常见卡点
配置完却没生效，大概率掉进下面任一坑里：
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 改的是
Files里的其他模板（比如Python Class或自定义模板），而不是Python Script - 新建文件方式不对：用
File → New → File不触发模板；必须用File → New → Python File或项目面板右键 →New → Python File - 模板末尾缺空行：如果最后一行是
'''，紧接着就是def main():，PyCharm 会把它连成一行，破坏语法。务必在模板结尾加一个空行
推荐一个稳妥可用的模板开头
复制粘贴这段到 Python Script 编辑框，替换掉默认内容即可：
# -*- coding: utf-8 -*-
"""
@File : ${NAME}.py
@Author : ${USER}
@Date : ${DATE} ${TIME}
@Project : ${PROJECT_NAME}
"""注意：三引号文档字符串必须顶格，缩进会导致后续代码被当成字符串内容；${PROJECT_NAME} 在未打开项目时为空，不影响其他字段生成。
实际用起来，最易忽略的是「新建动作必须匹配模板类型」——PyCharm 不会把 Python Script 模板套用到任意新建文件上，只认准它自己定义的 Python File 创建路径。
