macos终端中应使用python3 -m http.server在项目根目录启动http服务并访问http://localhost:8000，避免file://协议触发cors；vs code终端需将npm全局bin路径添加至~/.zprofile并重启应用。
macOS 终端里怎么让 html 文件双击或命令行打开都用浏览器预览
默认情况下，open index.html 会调用系统默认浏览器，但容易卡在旧版本 Safari、或因 MIME 类型识别失败而下载而非渲染。关键不是装什么工具，而是确保文件被当成 text/html 处理。
实操建议：
- 用
open -a "Google Chrome" index.html显式指定浏览器，避免系统自动选择出错 - 检查文件扩展名是否为小写
.html（不是.HTML或.htm），macOS 对大小写不敏感但某些 CLI 工具会误判 MIME - 如果用
python3 -m http.server启服务，浏览器访问http://localhost:8000才能正确加载相对路径资源；直接open本地文件会触发 CORS，fetch()或模块导入直接失败
VS Code 内置终端运行 live-server 报 command not found
这不是 VS Code 的问题，是 macOS 的 shell 初始化机制导致：GUI 应用（如 VS Code）启动时不会读取 ~/.zshrc，所以 npm 全局 bin 路径没加进 $PATH。
常见错误现象：which live-server 在 iTerm 里有输出，在 VS Code 终端里为空；npm install -g live-server 成功但命令不可用。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- 确认全局安装路径：
npm config get prefix，通常是/opt/homebrew/lib/node_modules（Apple Silicon）或/usr/local/lib/node_modules（Intel） - 把对应路径下的
bin加进~/.zprofile（不是.zshrc），例如：export PATH="/opt/homebrew/lib/node_modules/.bin:$PATH" - 重启 VS Code（不是重开终端），让它重新加载 shell 环境
file:/// 协议下 XMLHttpRequest 或 import 本地 JS 失败
这是浏览器安全策略的硬限制，和 macOS 无关，但新手常以为是环境没配好。只要地址栏显示 file:///，所有跨文件请求都会被拒绝，控制台报 Cross origin requests are only supported for protocol schemes。
使用场景：想快速测一个带 fetch 的 HTML 页面，或用 ES Module 加载 ./utils.js。
实操建议：
- 必须起本地 HTTP 服务，
python3 -m http.server 8000最轻量，然后访问http://localhost:8000/index.html - 不要用
live-server启动后还手动拖文件进浏览器——它会覆盖成file://协议 - 如果要用模块语法，确保服务器返回的
Content-Type是text/javascript，Python 自带服务器默认支持，不用额外配置
中文路径或空格导致 open 或 python -m http.server 报错
macOS 终端对空格和中文处理比 Windows 更严格，open my project/index.html 会被拆成两个参数，python -m http.server 在含中文路径下可能抛 UnicodeEncodeError。
实操建议：
- 路径含空格时，一律用引号包裹：
open "my project/index.html"，或者用反斜杠转义：open my\ project/index.html - 中文路径尽量避免，实在要放，先用
cd进入目录再执行命令，比直接传绝对路径更稳 - 如果
python -m http.server报编码错，说明当前 shell 的 locale 不是 UTF-8，运行locale检查，缺失就加export LANG=en_US.UTF-8到~/.zprofile
最常被忽略的是：HTTP 服务的根目录决定了所有相对路径的起点，python -m http.server 必须在项目根目录运行，而不是在子文件夹里执行再访问上级路径——浏览器发的请求路径是相对于服务根的，不是你终端当前路径。
