保存HTML文件必须用.html或.htm扩展名;记事本需选“所有文件”、手动输index.html、编码选UTF-8,禁用空格和中文命名,首页推荐index.html以兼容服务器默认查找规则。

保存HTML文件必须用 .html 或 .htm 扩展名
浏览器只认 .html 和 .htm 两种后缀,其他如 .txt、.rtf 或没写后缀的文件,双击打不开或显示为乱码。Windows 记事本默认会偷偷加 .txt,这是最常踩的坑。
操作时务必在“另存为”对话框中:
• 文件名栏输入完整名称,例如 index.html 或 about.htm
• “保存类型”选“所有文件”,不是“文本文档 (*.txt)”
• 编码选 UTF-8(不能选 ANSI 或 GB2312,否则中文变问号)
命名要小写+字母数字+下划线,禁用空格和中文
服务器和多数开发工具对大小写敏感,About.html 和 about.html 是两个不同文件;空格和中文会导致路径解析失败、CSS/JS 引入 404、Git 提交异常。
正确示例:
• 首页: index.html
• 产品页: product_list.html
• 联系我们: contact_us.html
错误示例:
• About Us.html(含空格)
• 关于我们.html(含中文)
• ProductList.html(驼峰,易出错)
VS Code / 记事本等编辑器保存时的实操细节
用 VS Code 写完 HTML 后,直接 Ctrl+S 不够——它不会自动补扩展名,也不会强制 UTF-8。必须手动确认:
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML,微信编辑器可直接渲染,无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
• 保存前检查右下角状态栏显示的编码,点击它 → 选 Save with Encoding → UTF-8
• 文件名输入框里明确写出 .html,别依赖自动补全
• 如果已误存为 test.txt,重命名时要**显示文件扩展名**(Win10/11 默认隐藏),否则实际变成 test.txt.html
记事本更危险:不选“所有文件”就铁定存成 .txt;哪怕你输的是 home.html,它也会给你改成 home.html.txt。
为什么推荐用 index.html 作首页?
Web 服务器(如 Nginx、Apache)默认查找 index.html、index.htm、default.html 等作为入口。如果你命名为 start.html,访问 https://yoursite.com/ 就会 404,必须输完整路径 https://yoursite.com/start.html 才能打开。
所以:
• 根目录下放 index.html(不是 Index.html 或 INDEX.HTM)
• 子目录如 /blog/ 下也放 index.html,这样 /blog/ 能直接访问
• 不要依赖“首页自动跳转”,那是额外 JS 或服务器配置,没必要增加复杂度
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










