python脚本模板需包含utf-8编码声明、解释器路径、标准导入、main函数封装及if name == '__main__'调用,再按需添加sys.argv或argparse参数处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用Python写脚本时,直接从空文件开始容易漏掉编码声明、命令行参数处理或异常捕获等基础结构,导致后续调试困难或在不同环境运行失败。
创建可执行的Python脚本模板
第一步:在文本编辑器中新建一个.py文件,例如script.py。
第二步:顶部添加UTF-8编码声明和解释器路径,这两行必须紧贴文件开头,中间不能有空行:
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
第三步:紧接着写标准导入块,只导入最通用的模块——sys用于获取参数,os用于路径操作,logging用于简单日志输出:
import sys
import os
import logging
第四步:定义主函数main(),把所有逻辑封装进去,避免全局变量污染;同时在if __name__ == '__main__':下调用它,这是可复用和可测试的关键:
def main():
pass
if __name__ == '__main__':
main()
添加命令行参数支持
方法一:使用内置的sys.argv(适合极简场景)
在main()函数开头插入:args = sys.argv[1:],然后用if len(args)
方法二:用argparse(推荐,健壮且自带help)
在import块下方追加:import argparse;在main()开头初始化:parser = argparse.ArgumentParser(description="脚本用途说明");接着add_argument('--input', '-i', required=True, help='输入文件路径');最后用args = parser.parse_args()获取解析结果。
【不加description会导致运行python script.py -h时报错AttributeError】
加入基础日志与错误处理
在main()函数第一行添加日志初始化:
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
用try/except包裹核心逻辑体,捕获Exception而非裸except:
try:
# 主要代码放这里
except Exception as e:
logging.error(f"执行失败:{e}")
sys.exit(1)
这一步做完后,脚本已具备可执行性、参数识别能力、错误反馈机制和基本日志输出。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











