是纯语义化标签,仅用于标记文档中表示变量名的文本(如数学公式中的 n、api 路径中的 id),不声明变量、不执行逻辑、js 无法读取其含义;仅在说明性文本中使用,不可替代 let/const,勿嵌套 或用于属性值、代码块。

用 <var></var> 标签标记变量名,不是声明变量
<var></var> 是纯语义化标签,只用来告诉浏览器“这个词是个变量名”,比如公式里的 n、函数参数 callback、API 路径里的 id。它不执行、不绑定、不存储值,JS 读不到它的“含义”,也别指望它能替代 let 或 const。
哪些场景该用 <var></var>
只在文档描述中出现变量名时才用,核心是「说明」而非「运行」:
- 数学说明:“设
<var>n</var>为样本数量” - API 文档:“
GET /api/users/<var>id</var>” - 代码说明:“调用
fetch(<var>url</var>)”,注意这里<var>url</var>是形参名,不是字符串"url" - 配置说明:“将
<var>API_KEY</var>写入.env文件”
常见误用和坑
这些写法看着像,但语义错、效果差、甚至引发逻辑误解:
-
<var id="count">x</var>后试图用document.getElementById('count').textContent拿到 JS 变量x的值 —— 实际只返回字符串"x" -
<input name="<var>user_id</var>">:name 属性值就是字面量"<var>user_id</var>",<var></var>不会被解析或替换 - 把整个代码片段塞进
<var></var>:如<var>let x = 42</var>—— 应该用<code>或<pre class="brush:php;toolbar:false;"></pre> - 嵌套使用:
<code><var>url</var>是冗余的,<var></var>已含语义,<code>应包裹可执行片段(如<code>fetch(url))
<var></var> 和 <code> 怎么配合才自然
二者分工明确:<var></var> 表示“这是个变量名”,<code> 表示“这是段可引用的代码文本”。真实文档里常这样组合:
- ✅ 正确:描述调用方式 —— “传入
fetch(<var>url</var>)” - ✅ 正确:说明配置项 —— “设置
<var>DATABASE_URL</var>环境变量” - ❌ 错误:把
<var></var>当成 JS 变量容器,或当成<code>的子集去嵌套
最易被忽略的一点:它默认渲染为斜体,但这只是浏览器默认样式;真正价值在于语义——屏幕阅读器会用不同语调读出 <var></var> 内容,搜索引擎也能更好理解上下文。别为了“看起来像变量”而滥用,否则语义就塌了。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











