docs: note for inconsistency between dev and build (#6674)

vitejs · May 10, 2022 · 095543f · 095543f
1 parent 2b2858c
commit 095543f
Showing 1 changed file with 14 additions and 0 deletions.
diff --git a/docs/config/index.md b/docs/config/index.md
@@ -186,6 +186,20 @@ export default defineConfig(({ command, mode }) => {
 
   :::
 
+  ::: tip NOTE
+  Since dev and build implement `define` differently, we should avoid some use cases to avoid inconsistency.
+
+  Example:
+
+  ```js
+  const obj = {
+    __NAME__, // Don't define object shorthand property names
+    __KEY__: value // Don't define object key
+  }
+  ```
+
+  :::
+
 ### plugins
 
 - **Type:** `(Plugin | Plugin[])[]`