GB 日志1GB日志国标规范日志一、基础概念区分GB国家标准代号GB 强制性国标必须严格执行GB/T 推荐性国标企业自愿采用合同约定后具备约束力。GB日志指符合国家信息技术/工业自动化标准规范生成的系统运行日志、检测审计日志覆盖上位机软件、CT设备通讯、缺陷检测、用户操作全流程记录用于故障追溯、质量审计、合规验收。二、设备适用核心国标清单1. 通用日志基础标准必遵循GB/T 17143.6-1997 信息技术 开放系统互连 系统管理 第6部分日志控制功能工业软件日志底层通用规范定义日志生成、分级、存储、过滤、审计全部强制要素。日志4项必填字段精确时间戳NTP时钟同步、操作主体/账号、事件类型、执行结果日志分级紧急、告警、通知、调试4级要求覆盖登录登出、参数修改、设备通讯、检测任务、故障报错、文件读写。GB 17859-1999 计算机信息系统安全保护等级划分准则强制安全审计日志强制要求登录失败、权限变更、越权操作、数据删除不可缺失日志禁止手动删除篡改留存周期≥6个月。2. 工业设备/产线专用日志标准GB/T 23022-2022 两化融合 生产设备运行管理规范对接CT检测设备的产线上位机强制记录设备启停、数据采集、质量指标计算、异常缺陷报警、批量生产记录日志可追溯单台工件全检测链路。GB/T 39404-2020 工业机器人控制单元安全要求通用工控参考工业控制系统日志最低存储时长≥90天设备通讯中断、参数校准、体数据预处理去噪/板弯矫正/XY矫正操作必须留痕。3. 质量/检测业务配套规范GB/T 19892.4-2022 批控制 第4部分批生产记录IGBT批量检测业务日志规范直通率、误报率、空洞率、背钻尺寸测量结果、复判人员操作全部记入日志作为出厂质量追溯凭证。三、符合GB标准的日志分类1. 设备通讯日志对接CT设备记录软件与CT设备交互全流程设备连接建立/断开、体数据实时采集指令、成像参数下发、设备故障反馈必填字段设备编号、通讯报文、时间戳、通讯状态、异常码。2. 业务检测日志核心质量日志每片IGBT工件检测全记录预处理流程去噪、XY矫正、板弯矫正执行参数分层检测结果IGBT CHIP焊层空洞、DBC基板空洞、PIN引脚焊接、背钻残桩测量值自动计算指标直通率、误报率、不良分类复判操作操作人员账号、人工判定结果、缺陷定位备注。3. 系统操作审计日志安全合规GB强制项用户登录、配方编辑、模板修改、Git代码更新、临时文件删除、弹窗确认/取消操作ShareDialogService弹窗交互禁止缺失账号、操作内容、操作前后参数对比、操作时间。4. 程序运行故障日志代码异常、文件读写失败、图像加载报错、数据库存储失败、内存溢出包含异常堆栈、报错代码行号用于快速定位程序BUG。四、国标强制硬性约束开发Serilog日志必须满足不可篡改日志写入后禁止程序/人工删除、覆盖采用滚动日志加密归档。时间统一系统对接NTP服务器日志时间戳精确到毫秒消除多设备时差。存储周期生产检测日志≥6个月安全审计日志≥180天故障运行日志≥90天。分级输出Error/Fatal通讯中断、检测失败、程序崩溃Warning空洞接近阈值、采集延迟、板材轻微翘曲Info正常检测、模板加载、用户登录Debug开发调试参数生产环境可按需关闭。完整追溯链通过工件条码/批次号可在日志中一次性调取该工件CT成像采集→预处理→自动检测→人工复判全链路记录。六、和普通自定义日志核心区别普通日志仅记录报错GB日志全链路无遗漏操作、设备、质量、审计四类全部覆盖GB日志具备合规效力客户审厂、质量事故追溯、监管核查可直接作为凭证国标强制存储时长、防篡改、时间同步普通日志无约束易丢失、可随意删除。2UserControl3readonly 关键字完整讲解一、基础定义readonly用于修饰类的字段约束规则赋值时机仅两处声明字段时直接初始化构造函数内赋值构造执行完毕后全程不可二次修改仅能读取只能修饰实例字段 / 静态字段不能修饰局部变量、属性、方法。语法示例// 声明时直接赋值privatereadonlystring_logPathD:\Log\;// 构造内赋值privatereadonlyIDialogService_dialogService;publicLoginView(IDialogServicedialogService){_dialogServicedialogService;// 仅构造内可赋值}publicvoidTest(){_dialogServicenull;// 编译报错 readonly禁止二次赋值}二、和 const 核心区别工控项目高频混淆特性readonlyconst赋值时机声明/构造函数运行时赋值声明时必须硬编码编译期常量数据类型任意引用类型、值类型接口/类/字符串都支持仅基础值类型string、int、bool、double等内存实例字段每个对象独立副本静态常量全局唯一编译嵌入代码DI场景完美适配构造注入服务如Serilog、弹窗服务无法使用不能注入实例你的项目典型对比// const固定不变的文本、数值publicconstfloatRate30.0f;// readonlyDI注入的服务、运行时读取的配置路径privatereadonlyILogger_logger;privatereadonlyPicture_rDialog;三、分场景实战贴合XRayGUI代码1. DI注入服务最常用弹窗/日志/设备通讯所有通过构造函数注入的服务全部加readonly防止代码误覆盖服务实例publicpartialclassLoginView:Window{privatereadonlyIDialogService_DialogService;privatereadonlyILogger_Logger;publicLoginView(IDialogServiceDialog,ILoggerlogger){InitializeComponent();_DialogServiceDialog;_Loggerlogger;}// 业务方法只读使用无法修改实例publicvoidOpenCoorPreview(){_DialogService.ShowDialogModal(...);}}2. 运行时配置路径、设备编号程序启动从配置文件读取一次全程固定privatereadonlystring_DeviceIp;publicRecipeEditViewModel(AppSettingssettings){_DeviceIpsettings.DeviceIp;}3. 静态 readonly全局单例配置静态只读程序生命周期仅初始化一次publicstaticreadonlystringLogRootFolderPath.Combine(AppContext.BaseDirectory,GBLog);4. 禁止使用场景局部变量void Test(){ readonly int a1; }语法报错普通属性public readonly string Name {get;set;}不支持构造外需要重新赋值的字段缓存、可变状态变量。四、对你项目的开发收益代码安全避免多人协作误写代码覆盖注入的ShareDialogService、日志实例、CT设备通讯对象减少空引用崩溃规范MVVM分层View/ViewModel中注入的依赖服务统一标记readonly一眼区分「只读依赖」和「可变业务状态字段」性能微小优化CLR可优化只读字段内存访问大批量3D体数据循环处理时减少额外校验开销适配GB日志规范日志实例_logger标记readonly确保全局审计日志实例不会被篡改、替换满足日志追溯合规要求。五、常见编译报错无法对只读字段赋值构造函数除外错误业务方法里修改readonly字段修复如果需要修改移除readonly改用普通私有字段readonly字段必须在声明或构造内赋值错误只声明不赋值构造也未初始化修复声明赋默认值 / 构造函数完成注入赋值。5WPF上位机 Release 发布完整流程适配你的软件一、Release与Debug核心区别维度Debug调试模式Release发布模式代码优化无优化保留调试符号、断点、冗余代码编译器全优化删除无效代码、内联方法、精简堆栈调试信息完整pdb调试文件可断点调试默认剔除pdb无法附加VS调试异常表现未捕获异常弹窗、完整堆栈后台崩溃无弹窗日志仅留存你全局异常处理器记录的内容运行速度慢大量校验/日志缓冲启动、图像推理、轴运动响应速度提升30%~80%文件体积输出文件夹大包含调试资源可裁剪冗余依赖打包体积更小适用场景开发、排错、写功能交付产线、客户现场、软著提交、量产部署重点提醒你写的InitExceptionHandler全局异常捕获在Release依然生效是产线故障日志唯一来源。二、VS切换Release编译配置1. 切换配置VS顶部菜单栏「解决方案平台」旁下拉框默认是Debug切换为Release右键解决方案 → 配置管理器全部项目「活动解决方案配置」统一设为Release平台统一选x64工控机都是64位避免AnyCPU兼容性问题。2. 项目Release关键配置I右键→属性1生成选项卡优化代码勾选输出路径自定义发布目录如.\Publish\Release方便打包目标框架和Debug保持一致.NET6/.NET8 Desktop取消「定义DEBUG常量」Release不会走#if DEBUG调试分支代码。2发布选项卡单文件打包工控一键部署发布目标文件夹部署模式独立部署自带.NET运行时工控机不用预装框架文件发布选项勾选「生成单个文件」「裁剪未使用代码」排除内容剔除调试pdb、设计器资源、测试图片减小包体积架构x64运行时win-x64。3代码相关适配Release避坑全局日志SerilogRelease建议保留文件日志关闭控制台输出调试专用弹窗/测试按钮用#if DEBUG包裹Release自动移除#ifDEBUGMessageBox.Show(调试提示);#endif轻量化模型/图像推理Release优化后速度提升无需额外改代码不要依赖Debug断点定位问题所有故障依靠你写的全局异常日志排查。三、Release编译打包操作步骤切换解决方案配置到Release、平台x64右键解决方案 →重新生成解决方案必须重新生成清除Debug缓存重点确保无任何编译报错之前的ViewModel、MaterialIcon、命名空间报错必须全部修复否则Release编译失败右键UI项目 → 发布按发布向导配置独立部署、单文件、输出目录完成发布输出目录得到XRayGUI.exe单文件配套资源文件夹打包交付生产交付打包exe、设备配置模板、操作手册、日志目录软著交付提供Release编译后的完整程序包附操作手册。四、Release高频踩坑解决方案1. Release编译失败但Debug正常根源代码存在未初始化变量、泛型裁剪冲突、缺失xmlns/using、类型引用断裂解决先把Debug下所有红色波浪线、编译报错全部修复再切Release编译。2. Release运行闪退Debug完全正常裁剪代码误删公共类库/ViewModel发布设置关闭「裁剪未使用代码」或添加裁剪保留配置路径问题Release工作目录和Debug不同相对路径读取配置/图片失败改用绝对路径第三方库缺失Material.Icons.WPF、CommunityToolkit.Mvvm、Halcon视觉库未设置「复制到输出目录」全局异常日志排查打开程序目录Logs文件夹查看崩溃堆栈定位代码。3. 设计器XAML报错只影响Release打包只要编译阶段报XDG类XAML错误Release生成会直接中断必须先修复所有UserControl.Resources、MaterialIcon、LoginViewModel命名空间报错。4. 单文件Release启动慢独立部署自带.NET运行时首次解压耗时可拆分打包把运行时和程序分开存放。五、适配你项目的Release专属优化建议日志分级Release把LogInformation降级仅保留Error/Fatal异常日志减少磁盘写入损耗AI大模型模块Release加载轻量化本地模型禁用云端调试接口资源释放强化Release下图像、相机、轴设备资源释放逻辑增强依托NavigateFrom接口做兜底清理关闭调试提示所有调试弹窗、测试开关用#if DEBUG隔离产线界面干净打包归档Release包配套你写的软著操作手册作为软件成品提交材料。6一、整体作用这是一段WPF 线性渐变画刷LinearGradientBrush用于给控件Border/Grid/Button 背景、矩形填充等生成垂直从上到下的渐变底色。关键参数释义StartPoint0.5,0 EndPoint0.5,1WPF 渐变坐标系规则(X,Y)取值范围0~1StartPoint0.5,0渐变起点 → 容器顶部水平居中EndPoint0.5,1渐变终点 → 容器底部水平居中效果纯垂直上下渐变无左右倾斜适合窗口面板、侧边栏背景。二、渐变断点 GradientStop 逐行解释1. 第一个断点GradientStopOffset0.4Color{StaticResource Color5}/Offset0.4在总高度40%位置切换颜色Color{StaticResource ColorBlue5}引用全局资源字典里定义的含义从顶部到容器40%高度颜色为色。2. 第二个断点GradientStopOffset0.9Color{StaticResource ColorGray5}/Offset0.9在总高度90%位置切换颜色Color{StaticResource ColorGray5}全局半透灰色资源含义40%高度 ~ 90%高度颜色从色平滑过渡到灰色90%到底部保持灰色不变。完整渐变分段效果0% ~ 40%纯色40% ~ 90%蓝 → 灰 平滑渐变过渡90% ~ 100%纯色半透灰。7