Unity3d 如何屏蔽警告(黄色输出)(公众号笔记)

ABSTRACT

2018-02 公众号笔记。Unity 没有警告开关设置,介绍三种屏蔽编译警告的方法:全局 mcs.rsp 响应文件、单文件 pragma warning disable、代码段 disable/restore 配对,并给出粒度选择的建议。

核心要点

  • 警告的价值:编译器认为「很可能是 bug」但不确定(确定的就是编译错误);多数警告应修代码而非屏蔽,只有明确有特殊编写目的时才屏蔽。
  • 方法一(全局):Assets 目录下创建 mcs.rsp,每行写 -nowarn:0642(数字取自 Console 中 CS 后的编号),改任意文件触发重新编译生效;简单粗暴、易误伤有用警告,不推荐。
  • 方法二(单文件):文件顶部写 #pragma warning disable 0162,整个文件忽略该编号警告。
  • 方法三(代码段):#pragma warning disable 0618#pragma warning restore 0618 配对包裹目标代码,粒度最细,推荐。
  • 典型场景:用 const 控制逻辑路径导致部分代码永远不可达(unreachable code 警告)。

关键实体与概念

mcs.rsp、#pragma warning、编译警告、CS 错误编号、unreachable code

关联概念

来源回溯

  • 原始文件:raw/ip/wechat_articles/Unity3d 如何屏蔽警告(黄色输出).md(2018-02-01)

时效性评估

  • 仍有效#pragma warning disable/restore 是 C# 语言级特性,至今通用。
  • 已过时mcs.rsp 对应旧版 Mono 编译器;现代 Unity 用 csc.rsp(Roslyn 编译器响应文件),或在 asmdef/Project Settings 中配置,思路相同文件名不同。也可通过 .editorconfig 按规则抑制特定诊断,粒度更现代。