MacOS中Nginx中文路径乱码或404的根源在于链路编码与权限未对齐：需确保终端locale为UTF-8、文件系统路径真实存在且各级父目录有x执行权限、Nginx配置中root用英文双引号包裹中文路径、浏览器URL为UTF-8百分号编码，并通过error.log核对实际访问路径。
MacOS 中 Nginx 默认能正确处理中文路径，但实际使用中出现乱码、403 或 404，通常不是 Nginx 本身不支持，而是编码、文件系统、权限或配置细节没对齐。关键不在“开启中文支持”，而在确保整个链路（终端、文件系统、Nginx、浏览器）统一用 UTF-8，且路径真实可访问。
确认文件系统与终端编码为 UTF-8
macOS 的 APFS/HFS+ 文件系统原生支持 Unicode（包括中文路径），无需额外设置。但终端和 shell 环境需确保输出/输入为 UTF-8：
- 运行
locale，检查LANG和LC_ALL是否含UTF-8（如en_US.UTF-8）。若不是，添加到~/.zshrc：export LANG=en_US.UTF-8export LC_ALL=en_US.UTF-8
然后执行source ~/.zshrc - 终端应用（如 Terminal 或 iTerm2）需在偏好设置中启用 UTF-8 编码（通常默认已开启）
路径必须真实存在且有执行权限
Nginx 要进入中文目录（比如 /Users/你的名字/Sites/我的项目），不仅目录要存在，它的每一级父目录都必须对 Nginx 进程有 执行权限（x）——这是 macOS 上最容易忽略的一点。
- 先创建路径，例如：
mkdir -p "/Users/$(whoami)/Sites/我的项目"echo "<h1>你好世界</h1>" > "/Users/$(whoami)/Sites/我的项目/index.html" - 逐级加执行权限（否则 Nginx 无法
chdir进入）：chmod +x "/Users/$(whoami)"chmod +x "/Users/$(whoami)/Sites"chmod +x "/Users/$(whoami)/Sites/我的项目" - 验证：用
ls -ld "/Users/$(whoami)/Sites/我的项目"确认输出中有x（如drwxr-xr-x）
server 配置中 root 使用完整中文路径
在虚拟主机配置（如 /opt/homebrew/etc/nginx/servers/zh-site.conf）中，直接写中文路径即可，Nginx 会自动按 UTF-8 解析：
- 示例配置段：
server {<br> listen 8080;<br> server_name localhost;<br> root "/Users/你的名字/Sites/我的项目";<br> index index.html;<br> location / {<br> try_files $uri $uri/ =404;<br> }<br>} - 注意：
root值两端必须用英文双引号包裹，避免 shell 解析出错；路径中不能有未转义的空格或特殊符号（中文汉字、数字、字母、下划线、短横线均可） - 修改后务必运行
sudo nginx -t校验语法，再sudo nginx -s reload
浏览器访问时 URL 编码要正确
现代浏览器（Chrome/Safari/Firefox）对中文路径会自动做 UTF-8 编码，所以直接访问 http://localhost:8080/页面.html 没问题。但调试时若手动拼 URL，请确保中文字符是标准 UTF-8 编码形式（如 %E9%A1%B5%E9%9D%A2.html），而不是 GBK 或其他编码。
- 可在终端用 Python 快速验证编码：
python3 -c "print('页面.html'.encode('utf-8').hex())"→ 输出e9a1b5e99da22e68786d6c，对应 URL 中的%E9%A1%B5%E9%9D%A2.html - 如果访问返回 404，用
tail -f /opt/homebrew/var/log/nginx/error.log查看是否报 “No such file or directory”，再核对日志里打印的实际路径是否与磁盘路径完全一致（包括空格、全角/半角符号）
