diff --git a/packages/abc/qr/index.en-US.md b/packages/abc/qr/index.en-US.md
index d5aa151533..4d60d5d34a 100644
--- a/packages/abc/qr/index.en-US.md
+++ b/packages/abc/qr/index.en-US.md
@@ -5,8 +5,11 @@ title: qr
 subtitle: QR
 cols: 1
 module: import { QRModule } from '@delon/abc/qr';
+deprecated: true
 ---
 
+# Will be removed in 18.0.0, please use [nz-qrcode](https://ng.ant.design/components/qr-code) instead.
+
 Generate a QR code based on [qrious](https://github.com/neocotic/qrious).
 
 
diff --git a/packages/abc/qr/index.zh-CN.md b/packages/abc/qr/index.zh-CN.md
index bb71370760..55a63288a1 100644
--- a/packages/abc/qr/index.zh-CN.md
+++ b/packages/abc/qr/index.zh-CN.md
@@ -5,8 +5,11 @@ title: qr
 subtitle: 二维码
 cols: 1
 module: import { QRModule } from '@delon/abc/qr';
+deprecated: true
 ---
 
+# 将在 18.0.0 中移除，请使用 [nz-qrcode](https://ng.ant.design/components/qr-code) 替代
+
 基于 [qrious](https://github.com/neocotic/qrious) 生成二维码。
 
 默认二维码的操作并不是刚需的原因，因此采用一种延迟加载脚本的形式，可以通过[全局配置](/docs/global-config)配置来改变默认 CDN 路径，默认情况下使用 `https://cdn.jsdelivr.net/npm/qrious/dist/qrious.min.js`。或安装 `npm i --save qrious` 依赖包并在 `angular.json` 的 `scripts` 引用 `"node_modules/qrious/dist/qrious.min.js"`。
diff --git a/packages/abc/qr/qr.component.ts b/packages/abc/qr/qr.component.ts
index db8fe41e5e..935001b46e 100644
--- a/packages/abc/qr/qr.component.ts
+++ b/packages/abc/qr/qr.component.ts
@@ -21,6 +21,10 @@ import type { NzSafeAny } from 'ng-zorro-antd/core/types';
 import { QR_DEFULAT_CONFIG } from './qr.config';
 import { QROptions } from './qr.types';
 
+/**
+ * Will be removed in 18.0.0, please use [nz-qrcode](https://ng.ant.design/components/qr-code) instead.
+ * @deprecated
+ */
 @Component({
   selector: 'qr',
   exportAs: 'qr',
diff --git a/packages/abc/qr/qr.module.ts b/packages/abc/qr/qr.module.ts
index e462787877..d2d878ecef 100644
--- a/packages/abc/qr/qr.module.ts
+++ b/packages/abc/qr/qr.module.ts
@@ -5,6 +5,10 @@ import { QRComponent } from './qr.component';
 
 const COMPONENTS = [QRComponent];
 
+/**
+ * Will be removed in 18.0.0, please use [nz-qrcode](https://ng.ant.design/components/qr-code) instead.
+ * @deprecated
+ */
 @NgModule({
   imports: [CommonModule],
   declarations: COMPONENTS,