代码气味 - 未解析的元标签

不完整的元标签是不专业的

tl;dr：不完整或空元标记会破坏功能和用户体验。

问题

• 标签出现在输出中
• 电子邮件文本包含人类可读文本之间的占位符
• 丢失的占位符会让用户感到困惑
• 网站呈现奇怪的字符
• 空值会触发错误
• 潜在的安全注入漏洞

解决方案

1. 验证元标记
2. 尽早断言完整性
3. 快速失败
4. 避免空值
5. 抛出有意义的异常
6. 自动元验证

语境

当您留下未完成的元标记（例如 {user_name} 或 {product_name}）时，它们通常会潜入您的最终输出中。想象一下发送一封电子邮件，内容是：“您好 {user_name}，您的 {product_name} 订单已准备就绪。”

它让人尖叫不专业并且让用户感到困惑。

空值会导致崩溃或静默故障，从而导致糟糕的用户体验或进程中断，从而使情况变得更糟。

您可以通过在渲染或发送之前断言完整性来避免这种情况。

当您的代码发现不完整的元标记或空值时，立即停止进程并抛出异常。

示例代码

错误的

  
  
  正确的








  
  
  检测


[x] 自动 

您可以通过自动化测试或短绒扫描未完成的占位符（{} 或类似模式）来检测这种气味。 

  
  
  标签



快速失败


  
  
  等级


[x] 初学者

  
  
  为什么双射很重要


在使用占位符表示用户数据时，您的系统必须维护一对一的映射。 

如果您的 {user_name} 占位符存在但缺少相应的真实姓名，则您将破坏此映射。 

这会导致错误、混乱以及对您的应用程序失去信任。 

确保双射合规性可以避免这些问题。

  
  
  人工智能一代


人工智能工具有时会在生成带有占位符的模板时引入这种气味，但无法替换真实数据。 

							

								
								

									eMart 网店系统
									
功能列表：底层程序与前台页面分离的效果，对页面的修改无需改动任何程序代码。完善的标签系统，支持自定义标签，公用标签，快捷标签，动态标签，静态标签等等，支持标签内的vbs语法，原则上运用这些标签可以制作出任何想要的页面效果。兼容原来的栏目系统，可以很方便的插入一个栏目或者一个栏目组到页面的任何位置。底层模版解析程序具有非常高的效率，稳定性和容错性，即使模版中有错误的标签也不会影响页面的显示。所有的标
								
								下载 
							
						

在使用输出之前，您必须验证并完成所有占位符。

  
  
  人工智能检测


如果您正确配置，诸如 linter 或电子邮件渲染验证器之类的 ai 工具可以检测未完成的元标记。 

使用这些工具自动进行元标记检测并减少人为错误。

  
  
  尝试一下！


记住：人工智能助手会犯很多错误



without proper instructions
with specific instructions



chatgpt
chatgpt


claude
claude


perplexity
perplexity


copilot
copilot


gemini
gemini




  
  
  结论


不完整的元标记不仅仅是草率，而且是有害的。验证标签、断言完整性并在需要时引发异常。 

仔细处理元标签可以防止错误并确保专业体验。

  
  
  关系




  
    

      

  
  
    

      
代码气味 12 - 空
      
马克西·孔蒂耶里 ・2020 年 10 月 31 日
      

        #codenewbie
        ＃教程
        #哎呀
      
    
  






  
    

      

  
  
    

      
code smell 139 - 用户界面中的业务代码
      
马克西·孔蒂耶里 ・22 年 6 月 9 日
      

        #哎呀
        #webdev
        #javascript
        #初学者
      
    
  





  
    

      

  
  
    

      
code smell 97 - 没有同理心的错误消息
      
马克西·孔蒂耶里 ・2021 年 10 月 27 日
      

        #开源
        #ux
        ＃编程
        #javascript
      
    
  




  
  
  更多信息




  
    

      

  
  
    

      
快速失败
      
马克西·孔蒂耶里 ・2020 年 12 月 6 日
      

        #codenewbie
        ＃编程
        #webdev
        #哎呀
      
    
  





  
    

      

  
  
    

      
空：十亿美元的错误
      
马克西·孔蒂耶里 ・ 十一月 18 '20
      

        #codenewbie
        ＃教程
        ＃编程
        #webdev
      
    
  




  
  
  免责声明


代码味道是我的观点。


  
  
  制作人员


托马斯·马丁内斯 (tomas martinez) 在 unsplash 上拍摄的照片




最好的错误消息是永远不会出现的错误消息。


托马斯·福克斯



  
    

      

  
  
    

      
软件工程精彩名言
      
马克西·孔蒂耶里 ・ 2020 年 12 月 28 日
      

        #codenewbie
        ＃编程
        ＃引号
        ＃软件
      
    
  





本文是 codesmell 系列的一部分。



  
    

      

  
  
    

      
如何查找代码中的臭部分
      
马克西·孔蒂耶里 ・ 21 年 5 月 21 日
      

        #codenewbie
        ＃教程
        #代码质量
        #初学者