Visual Studio 不适合前端新手写 HTML，因其默认将 .html 视为 ASP.NET 资源，易引发模板干扰、404 错误、补全失效等问题；应避免新建 Web 项目，改用“文件→新建→文件”，配合 Live Server 插件和正确文件属性设置。
Visual Studio 不是写 HTML 的推荐工具，尤其对前端新手来说，它会把简单事情变复杂。
VS 里新建 HTML 文件总弹出 ASP.NET 模板？
这是 VS 默认把 .html 当作 Web 项目资源处理，尤其装了 ASP.NET 工作负载后。你没写后端，却被迫面对 _Layout.cshtml、wwwroot、Razor 语法高亮错乱等问题。
- 新建纯 HTML 项目前，先确认安装的是「ASP.NET 和 Web 开发」还是「.NET 桌面开发」——后者更轻量，不自动注入 Web 框架逻辑
- 如果只是编辑单个 HTML 文件，用「文件 → 新建 → 文件」，选
HTML 文件，**不要点「新建项目」**；否则默认创建的是 ASP.NET Core Web App - 若已建错项目，删掉
Startup.cs、Program.cs、Controllers/等目录也没用——VS 仍按 Web 项目逻辑编译和调试，建议直接关掉重来
Live Server 不工作，F5 刷新全是 404？
VS 自带的「在浏览器中查看」（Ctrl+Shift+W）只支持完整 Web 项目，对独立 index.html 常返回 HTTP Error 404.15 - Not Found，因为它试图走 MVC 路由，而不是静态文件服务。
- 别依赖 VS 内置预览，装官方插件
Live Server（注意：不是 VS Code 的那个，是 Visual Studio 版本，搜索 Marketplace 时认准 publisher 是Visual Studio Team） - 启用前右键
index.html→ 「在外部浏览器中打开」能绕过 404，但无热更新；Live Server插件启动后地址通常是http://127.0.0.1:5500/index.html，不是file://协议 - 如果页面里用了
fetch('./data.json')，必须走Live Server启的服务，否则跨域报net::ERR_FILE_NOT_FOUND
IntelliSense 对 class/id 补全失效，CSS 里写 .btn 没提示？
VS 默认只对 ASP.NET 的 .cshtml 做深度 HTML/CSS/JS 联动补全，纯 .html 文件里 CSS 类名不会从同目录 style.css 中提取。
立即学习“前端免费学习笔记（深入）”；
- 手动开启：右键 HTML 文件 → 「属性」→ 把
Content Type改成Content（不是None或Embedded Resource） - CSS 文件必须和 HTML 在同一项目内，且生成操作为
Content，否则 VS 不扫描它里面的类名 - 即便设置正确，VS 对原生 CSS 的补全也弱于 VS Code + Tailwind 插件；如需高频 class 编写，建议改用轻量编辑器
VS 的强项是调试 C#、集成 IIS Express、部署到 Azure，不是写静态页面。如果你只是改几个按钮样式、调接口、做原型，它反而拖慢节奏——路径配置、项目类型、服务协议这些细节，比写 HTML 本身还耗神。
