Visual Studio 仅作为HTML5项目的编辑和构建工具，部署到Linux需手动配置Web服务器（如Nginx），确保静态资源路径正确、大小写敏感、MIME类型完备，并通过HTTP协议访问以支持完整API功能。
Visual Studio 写 HTML5 项目部署到 Linux 时，VS 本身不参与运行时配置
VS 只是编辑器和构建辅助工具（比如用它启动本地服务器、打包或调用 webpack），HTML5 本质是静态资源，部署到 Linux 就是把 index.html 和相关 JS/CSS/asset 文件扔进 Web 服务器的根目录。VS 不会自动生成或修改 Linux 服务器的配置，也不“知道”你部署到哪——它连 /etc/nginx/conf.d/ 都碰不到。
常见误解是以为 VS 里点“发布”就能直接配好 Nginx/Apache，其实那只是把文件拷过去，后续全靠你手动配 Web 服务。
Linux 上跑 HTML5 必须配 Web 服务器，不能直接双击打开 index.html
浏览器直接打开本地 file:// 路径会禁用 fetch、WebGL、Service Worker 等 API，尤其跨域请求（如调后端 API）必然失败。Linux 部署必须走 http:// 或 https:// 协议。
- Nginx 是最轻量常用选择：把构建输出目录（如
dist/）设为root，加一行try_files $uri $uri/ /index.html;支持前端路由（Vue Router / React Router 的 history 模式） - Apache 需启用
mod_rewrite，对应配置.htaccess或主配置里写RewriteRule - 临时调试可用 Python：
python3 -m http.server 8000 --directory dist/，但仅限测试，不可用于生产
路径和资源引用在 Linux 部署前就得写对，别依赖 VS 本地预览路径
VS 内置浏览器预览常走 http://localhost:port/some-folder/，容易让人误用相对路径如 ./api/users 或 ../assets/logo.png。Linux 部署后 URL 根路径可能不同，导致 404。
立即学习“前端免费学习笔记（深入）”；
- 所有静态资源用根相对路径：
/css/app.css、/img/icon.svg，而不是css/app.css - API 请求地址统一配环境变量：开发用
http://localhost:3000/api，生产用/api（由 Nginx 反向代理到后端） - Vue CLI / Vite 项目检查
public/下资源是否被正确 copy，避免硬编码./public/xxx - 构建前确认
base配置（Vite 的base，Vue CLI 的publicPath）是否匹配部署路径（如部署在子路径/myapp/，则base得设成/myapp/）
权限、大小写、MIME 类型这些细节 Linux 会较真，Windows 不报错不代表没问题
Linux 文件系统区分大小写，Image.jpg 和 image.jpg 是两个文件；Nginx 默认不返回 .webp 或 .woff2 的正确 MIME 类型；文件权限不对会导致 403。
- 检查所有
src、href中的文件名拼写，大小写必须完全一致 - Nginx 配置里补上常见前端 MIME 类型：
types { application/font-woff2 woff2; image/webp webp; } - 确保部署目录对 Nginx worker 进程可读：
chmod -R 755 dist/，且属主是www-data（Ubuntu）或nginx（CentOS） - 用
curl -I http://your-domain/favicon.ico看返回的Content-Type是否正确，不是text/plain
