Winapi.Windows与Vcl.Graphics的TBitmap命名冲突解决方法

给你几个实际开发里能用的解决办法：

1. 直接用单元全名限定类型 #

每次用到TBitmap时，明确指定所属单元，编译器就不会混淆：

// 声明Vcl的位图对象
var
  VclBmp: Vcl.Graphics.TBitmap;
// 声明Windows API里的位图结构（如果需要的话）
var
  WinBmp: Winapi.Windows.TBitmap;

这种方法最直接，不需要额外配置，适合偶尔需要区分的场景。

2. 给单元设置别名简化代码 #

在uses语句里给Vcl.Graphics设置别名，后续用别名指代，代码更简洁：

uses
  Winapi.Windows,
  Vcl.Graphics as Gfx; // 给Vcl.Graphics起别名Gfx

// 用别名声明对象
var
  Bmp: Gfx.TBitmap;

如果需要频繁使用Vcl的TBitmap，这个方法能减少重复输入的长度。

3. 全局重定向TBitmap到Vcl版本 #

如果你的代码里几乎只用Vcl.Graphics的TBitmap，完全不需要Winapi.Windows里的同名结构，可以直接在uses之后全局重定义：

uses
  Winapi.Windows,
  Vcl.Graphics;

// 把全局TBitmap指向Vcl的版本
type
  TBitmap = Vcl.Graphics.TBitmap;

// 后续直接用TBitmap就是Vcl的版本
var
  Bmp: TBitmap;
// 如果偶尔需要Windows的版本，还是用全名限定
var
  WinBmp: Winapi.Windows.TBitmap;

这个方法适合大部分只需要Vcl位图的场景，日常写代码不用每次加前缀。

4. 排除Winapi.Windows里的TBitmap符号 #

用Delphi的编译指令直接排除Winapi.Windows中的TBitmap定义，彻底避免冲突：

// 在引用Winapi.Windows之前，先排除TBitmap符号
{$EXCLUDESYMBOL TBitmap}
uses
  Winapi.Windows,
  Vcl.Graphics;

// 此时TBitmap默认就是Vcl.Graphics的版本
var
  Bmp: TBitmap;

注意这个指令要写在uses Winapi.Windows之前，确保编译器不会导入该符号。

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