如何在PhpStorm中为独立脚本文件使用@deprecated注解并显示删除线？

针对独立脚本文件（不依附任何类），可以用以下几种实用方式标记为待移除状态，兼顾编辑器内的视觉提醒（类似删除线效果）和运行时警示：

• 注释内添加Markdown删除线（编辑器兼容）
  多数主流IDE（VS Code、IntelliJ系列等）支持识别注释中的Markdown语法，直接在脚本开头的注释块里用~~包裹待提示内容，就能显示删除线效果，同时明确标注废弃原因：

  #!/usr/bin/env python
  # ~~此脚本已标记为废弃，将在后续提交中移除~~
  # 原用途：处理XX旧逻辑
  # 替代方案：使用新脚本new_processor.py
  

  Shell脚本示例：

  #!/bin/bash
  # =====================================
  # DEPRECATED: ~~本脚本计划在下次迭代删除~~
  # 请勿新增调用，已有调用请尽快迁移
  # =====================================
  

• 运行时抛出废弃警告
  如果脚本还会被调用，可以在开头加入代码逻辑，运行时主动输出警告，避免误使用：
  Python脚本用标准库抛出警告：

  import warnings
  warnings.warn("该脚本已废弃，将在后续提交移除", DeprecationWarning, stacklevel=2)
  
  # 原有业务代码...
  

  Shell脚本直接输出错误流警告：

  echo "⚠️ 警告：此脚本已标记为废弃，将在后续提交中移除" >&2
  

• 文件名直观标记
  直接修改脚本文件名，添加_deprecated或_to_remove后缀，比如data_sync.sh改成data_sync_deprecated.sh，不用打开文件就能快速识别这是待删除的废弃脚本。

• IDE高亮标记（配合注释）
  用IDE支持的自定义注释标签，比如TODO: [DEPRECATED]，配合TODO高亮插件，让脚本在编辑器中显示特殊样式（部分插件支持配置删除线效果）：

  // TODO: [DEPRECATED] ~~此脚本将在后续提交移除~~
  // 原功能：处理旧版API请求
  

内容的提问来源于stack exchange，提问作者exts