如何让Python的webbrowser.open()在macOS系统下正常工作

核心原因 #

macOS环境下（尤其是打包成.app后），webbrowser.open()失效通常是因为相对路径解析错误或打包后的工作目录与预期不符，另外.app的沙盒机制也可能限制文件访问权限。

解决方案 #

1. 改用绝对路径定位HTML文件

避免使用相对路径，先获取HTML文件的绝对路径再调用打开操作，示例代码：

import folium
import webbrowser
import os
import sys

# 生成地图
map = folium.Map(
    location=[39.82, -100],
    zoom_start=4)
folium.Marker(location=[39.82, -100]).add_to(map)

# 获取当前脚本/程序的目录
if hasattr(sys, '_MEIPASS'):
    # 打包成可执行文件后的临时目录（PyInstaller）
    current_dir = sys._MEIPASS
else:
    current_dir = os.path.dirname(os.path.abspath(__file__))

# 拼接HTML文件的绝对路径
html_path = os.path.join(current_dir, "Map.html")
map.save(html_path)

# 用绝对路径打开
webbrowser.open(f"file://{html_path}")

2. 调用macOS系统open命令替代webbrowser模块

如果webbrowser模块仍有问题，直接调用系统原生的open命令更可靠，示例：

import folium
import subprocess
import os
import sys

# 生成地图
map = folium.Map(location=[39.82, -100], zoom_start=4)
folium.Marker(location=[39.82, -100]).add_to(map)

# 获取绝对路径
current_dir = sys._MEIPASS if hasattr(sys, '_MEIPASS') else os.path.dirname(os.path.abspath(__file__))
html_path = os.path.join(current_dir, "Map.html")
map.save(html_path)

# 调用系统命令打开
subprocess.run(['open', html_path], check=True)

3. 打包成.app的额外配置（以PyInstaller为例）

• 打包时需确保程序能访问生成的HTML文件，可通过--add-data参数配置：

  pyinstaller --onefile --windowed --add-data "Map.html:." your_script.py
  

• 若动态生成HTML，建议将文件存放在用户有权限访问的目录（比如用户文档目录），避免沙盒限制：

  # 改用用户文档目录存放HTML
  html_path = os.path.join(os.path.expanduser("~"), "Documents", "Map.html")
  map.save(html_path)
  

内容的提问来源于stack exchange，提问作者Anna M