diff --git a/docs/matter.md b/docs/matter.md
index 0c02aa817f57c332961798188a5822ec4e7f95d5..6c14f36f0370f7a90dad4de7f584de00e4b809c9 100644
--- a/docs/matter.md
+++ b/docs/matter.md
@@ -186,6 +186,10 @@ vue页面在App端的渲染引擎默认是系统webview（不是手机自带浏
 
 ### 小程序开发注意@mp
 
+#### 文件命名
+`vue3` 项目，页面或组件目录下，不能使用与 `vue、nvue` 同名的 `js、ts` 文件。\
+小程序端 `vue` 文件会被编译为同名的 `js、json、wxml、wxss` 文件，如果存在同名 `js、ts` 文件，会导致冲突。
+
 #### 各家小程序实现机制不同，可能存在的平台兼容问题
 
 1. 浏览器内核差异