一个方法的备注，书写的好；
方便他人查看，方法的作用；
方便不进入方法就能查看，光标移动到方法上就行
方便查看传参，返回值
显得有 逼格吧！，规范化！
- 建议如下格式书写，方便阅读查看~
#!/usr/bin/env python
# -*- coding: utf-8 -*-
# @Time : 2025-02-14 14:31
# @Author : duxiaowei
# @File : report_css_into_html.py
# @Software: 将报告中的css文件插入到html文件中，方便jira下载查看
import osdef rewrite_html(html_file_path):"""将报告中的css文件插入到html文件中，方便上传jira，下载查看Args:html_file_path: 文件路径Returns:无Raises:写入失败"""path_html = os.path.abspath('..') + '\\test_API\\reports\\' + html_file_pathpath_css = os.path.abspath('..') + '\\test_API\\reports\\assets\\style.css'try:# 读取 HTML 文件内容with open(path_html, 'r', encoding='GB2312') as html_file:html_content = html_file.read()# 读取 CSS 文件内容with open(path_css, 'r', encoding='GB2312') as path_css:css_content = path_css.read()# 定义要查找的 <link> 标签link_tag = '<link href="assets/style.css" rel="stylesheet" type="text/css"/>'# 生成新的 <style> 标签内容style_tag = f'<style>\n{css_content}\n</style>'# 替换 <link> 标签为 <style> 标签new_html_content = html_content.replace(link_tag, style_tag)# 将修改后的内容写回 HTML 文件with open(path_html, 'w', encoding='GB2312') as html_file:html_file.write(new_html_content)# print("CSS 文件内容已成功插入到 HTML 文件中。")except FileNotFoundError:print("未找到 HTML 或 CSS 文件，请检查文件路径。")except Exception as e:print(f"处理文件时出现错误: {e}")