Atom中不存在emmet-jsx插件,应安装官方emmet插件(2.4.x),并配置jsx扩展及.keymap.cson语法域绑定;class不自动转className,需额外安装emmet-jsx-css-modules;Tab失效多因autocomplete-plus劫持,可关闭其Tab确认或改用Ctrl+Enter;嵌套缩写在JSX模式下受限,建议切HTML模式展开或分步操作。

emmet-jsx 插件根本不存在,别装错包
Atom 里没有叫 emmet-jsx 的独立插件——这是个常见误解。你搜到的所谓“emmet-jsx”基本是过时的废弃包(比如旧版 emmet-atom 或 emmet-snippets-compatibility),它们不兼容当前 Atom 版本,装了反而导致 emmet:expand-abbreviation 命令报 Cannot read property 'expand' of undefined。
正确做法只有一条:安装官方维护的 emmet 插件(作者 emmetio,包名就是 emmet,当前稳定版为 2.4.x)。它原生支持 JSX,但需要手动配两处才能生效:
- 在
Packages → emmet → Settings的Extensions输入框填:jsx: jsx - 在
Keymap…打开keymap.cson,追加语法域绑定:
'.source.js, .source.jsx': 'tab': 'emmet:expand-abbreviation'
注意:不要删掉原有内容,只追加;.source.jsx 是 Atom 对 React 文件的语法标识,不是文件后缀名。
class 属性自动转成 className 吗?不,默认不转
纯 emmet 插件本身不做属性映射。输入 div.container 按 Tab,出来的是 <div class="container"></div>,不是 className。React 场景下要自动转换,必须额外装 emmet-jsx-css-modules 插件(注意名字带 -jsx-)。
这个插件的作用很具体:
- 把缩写中的
class替换为className - 把
for替换为htmlFor - 对
style属性做对象化处理(如div[style=margin:10px]→style={{ margin: '10px' }})
但它依赖 emmet 插件先工作——没装 emmet,它连缩写都收不到。所以顺序不能错:先装并配置好 emmet,再装 emmet-jsx-css-modules,不用重启,但需重新打开 .jsx 文件。
Tab 键被 autocomplete-plus 劫持怎么办
在 JSX 文件里输完 div.app 按 Tab 没反应,大概率不是 Emmet 失效,而是 autocomplete-plus 弹出了补全菜单,把 Tab 当作“选中第一项”用了。此时光标卡在菜单里,Emmet 根本没收到事件。
临时验证方法很简单:
- 关闭所有非核心插件(只留
emmet和language-babel) - 新建一个 .jsx 文件,右下角确认语法是
JavaScript (JSX) - 输
div.app,确保光标在行尾,按 Tab —— 应立刻展开
如果这时好了,说明是快捷键冲突。长期解法有两个:
- 在
autocomplete-plus设置里关掉Use Tab to confirm suggestion - 或改用
Ctrl+Enter手动触发Emmet: Expand Abbreviation(命令面板可查)
为什么 .jsx 文件里 div>ul>li*3 不生成嵌套结构
这不是 Emmet 不支持,而是 JSX 语法域下部分缩写行为有差异。比如 div>ul>li*3 在 HTML 模式下能展开三层结构,但在 JSX 模式下可能只生成最外层 <div></div>,中间层级被截断。
原因在于 emmet-jsx-css-modules 为了适配 React 渲染逻辑,对嵌套缩写做了保守处理——它优先保证生成合法 JSX 语法,避免产出无法被 Babel 解析的结构(例如未闭合标签、非法子节点位置)。
绕过办法很直接:
- 切回
HTML语法模式写结构(右下角点一下选 HTML),用 Emmet 展开完整结构 - 再手动把
class改成className,把for改成htmlFor - 或者分步写:
div→ Tab →ul→ Tab →li*3→ Tab,每次只展一层
真正容易被忽略的,是 Atom 对语法域的识别粒度比 VS Code 更细——它看的是 data-grammar 属性值,不是文件后缀。哪怕文件叫 App.jsx,如果右下角显示的是 JavaScript 而不是 JavaScript (JSX),Emmet 就不会走 JSX 分支。多看一眼那个小标签,比重装十次插件都管用。


















