> **本文回答**：创建 Popup —— setHTML / setText / setDOMContent / setLngLat / addTo / remove / isOpen。
## 一、最简用法
```js
const popup = new vjmap.Popup()
.setHTML("Hello")
.setLngLat([lng, lat])
.addTo(map);
```
## 二、CAD 坐标
```js
popup.setLngLat(map.toLngLat([725.32, 18969.19]));
```
## 三、设置内容：三选一
### 3.1 HTML 字符串
```js
popup.setHTML("站点
温度 26℃
");
```
### 3.2 纯文本（自动转义）
```js
popup.setText("不会当 HTML 处理
"); // 显示为字面量
```
### 3.3 DOM 节点
```js
const div = document.createElement("div");
div.innerHTML = "Hello";
popup.setDOMContent(div);
```
## 四、生命周期
```js
const p = new vjmap.Popup().setHTML("Hi");
p.setLngLat([lng, lat]);
p.addTo(map);
p.isOpen(); // true
p.remove(); // 从地图移除
p.isOpen(); // false
// 再打开
p.addTo(map);
```
## 五、事件
```js
p.on("open", () => console.log("打开"));
p.on("close", () => console.log("关闭"));
```
⚠️ `close` 在每次 `remove()` 时都触发（含未打开时调 remove、对已打开 popup 再 `addTo` 时）；引擎还漏解绑 `preclick`，`closeOnClick: true` 的 popup 关闭后每次点地图都会**再次**触发 close。close 里的清理须幂等（`let done = false; popup.on("close", () => { if (done) return; done = true; /* 清理 */ })`），详见 [dynamic-content §八](dynamic-content.md#八popup-关闭时清理)。
## 六、点击地图自动弹
```js
const popup = new vjmap.Popup({ closeButton: false });
map.on("click", e => {
popup.setLngLat(e.lngLat).setHTML("点击经纬度：" + e.lngLat).addTo(map);
});
```
## 七、点击图层自动弹
```js
map.on("click", "my-layer", e => {
const f = e.features[0];
new vjmap.Popup()
.setLngLat(e.lngLat)
.setHTML(`名称：${f.properties.name}`)
.addTo(map);
});
```
## 八、延时关闭
```js
setTimeout(() => popup.remove(), 3000);
```
## 九、切换显示
```js
if (popup.isOpen()) popup.remove();
else popup.addTo(map);
```
## 十、常见坑
1. **没 setLngLat 就 addTo** → **不报错、静默不显示**（`_update` 的守卫条件是 `(this._lngLat||this._trackPointer)&&this._content`，lngLat 为空时直接跳过渲染）。必须先 setLngLat——症状是"popup 出不来"而非异常，调试时容易误判。
2. **setHTML 里写的 `