Python如何调用系统默认文本编辑器打开相对路径下的文本文件

核心依赖 macOS 系统原生的open命令实现，该命令会自动按照文件类型关联，唤起用户设置的默认编辑器打开目标文件，打开后不会阻塞主程序运行，支持窗口并排操作、独立关闭。

可直接运行的实现代码 #

注意：必须先基于脚本自身位置拼接文件绝对路径，不要直接写裸相对路径——相对路径默认取程序启动时的工作目录，从其他目录启动程序、或者打包后运行时很容易出现文件找不到的问题。

from pathlib import Path
import subprocess
import sys

# 定位当前Python主程序所在的绝对目录
SCRIPT_DIR = Path(__file__).resolve().parent
# 拼接帮助文件路径：同目录下的help.txt就直接写文件名，放在docs子目录就改成 SCRIPT_DIR / "docs" / "help.txt"
HELP_FILE = SCRIPT_DIR / "help.txt"

def launch_help_doc():
    # 提前校验文件存在，避免静默失败
    if not HELP_FILE.is_file():
        print(f"错误：帮助文件缺失，路径为 {HELP_FILE}", file=sys.stderr)
        return
    # 异步唤起系统默认程序打开文件，不阻塞主进程
    subprocess.Popen(
        ["open", str(HELP_FILE)],
        stdout=subprocess.DEVNULL,
        stderr=subprocess.DEVNULL
    )

需要触发打开帮助文档的时候，直接调用launch_help_doc()即可。

之前调用os/subprocess失败的常见原因 #

• 路径定位错误：直接写./help.txt这类相对路径，没有绑定脚本所在目录，工作目录变化后就会找不到文件。
• 调用方式导致阻塞：用os.system()、subprocess.run()默认会等待编辑器进程退出才会继续执行主程序，没法实现窗口并排操作，必须用subprocess.Popen()做异步调用。
• 命令拼接错误：自己拼接命令字符串而不是用列表传参，遇到路径带空格、中文、特殊字符时会出现转义错误，导致打开失败。
• 误用跨平台接口：os.startfile()是Windows专属接口，macOS下不存在该方法，调用会直接抛异常。

效果说明 #

调用后会直接唤起系统默认绑定对应文本格式的编辑器（比如系统自带「文本编辑」、用户自行设置的VSCode、Typora等），主程序窗口不会卡住，用户可以自由调整两个窗口位置并排操作，关闭编辑器也不会影响主程序运行。

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