合法可运行的index.html文件需满足三要素：纯文本格式、UTF-8无BOM编码、闭合完整的HTML结构；Windows记事本须选“所有文件”并手动设UTF-8，macOS TextEdit需先转纯文本再改后缀，且必须用浏览器以file:///协议打开。
直接创建一个合法、可运行的 index.html 文件，关键不是“有没有后缀”，而是三件事：文件必须是纯文本、编码必须是 UTF-8（无 BOM）、结构必须闭合完整。其他方法都只是路径差异，本质没区别。
用记事本或 TextEdit 保存时为什么打开是乱码或下载？
Windows 记事本默认保存为 ANSI 或 UTF-8 with BOM，macOS TextEdit 默认是富文本（RTF），这两者都会导致浏览器解析失败或乱码。
- Windows：保存时在“另存为”对话框中，“保存类型”选
所有文件，文件名输index.html，编码选UTF-8（不是“UTF-8-BOM”） - macOS：先点菜单
Format → Make Plain Text，再保存，扩展名手动输入.html，别让系统自动加.txt - 验证方式：用 VS Code 或 Sublime 打开该文件，右下角应显示
UTF-8，且无 BOM 标识；终端执行file -i index.html应返回charset=utf-8
命令行创建 HTML 文件最稳妥的写法
GUI 编辑器容易误操作，命令行能绕过编码陷阱，但 echo 在 Windows cmd 下默认不支持 Unicode，直接写中文会变问号。
htmlppt.skill
下载
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- PowerShell（推荐）：
Set-Content -Path index.html -Value '<meta charset="UTF-8"> <title>测试页</title> <h1>你好</h1>' -Encoding UTF8 - macOS/Linux：
printf '<meta charset="UTF-8"> <title>测试页</title> <h1>你好</h1>' > index.html - 别用
echo > file.html直接重定向中文内容——它在多数 shell 下默认走 locale 编码，不可靠
VS Code 中按 ! + Tab 没反应？检查这三点
Emmet 快捷键失效很常见，不是插件问题，而是上下文或配置错位。
立即学习“前端免费学习笔记（深入）”；
- 确保当前文件已设为
HTML语言模式（右下角显示HTML，不是Plain Text或Auto） - 文件必须已保存为
.html后缀，未保存的临时文件不触发 Emmet - 确认 Emmet 配置未被覆盖：打开设置搜索
emmet.includeLanguages，检查html是否在列表中；若用 Remote-SSH，需在远程设置里启用
最容易被忽略的是：HTML 文件本身不执行 JS 或 CSS，只负责结构。哪怕你写对了所有标签，如果双击用系统默认程序（比如 Word 或 WPS）打开，看到的只会是源码或乱码——必须用 Chrome/Firefox/Safari 等浏览器打开 file:/// 路径才能渲染。这个“打开方式”错误，比编码错误还常被当成代码问题排查。
