Mac系统下Python3中tkinter filedialog initialdir参数失效问题

问题复现代码 #

出现异常的完整代码：

from tkinter import *
from tkinter import filedialog
def done():
    text_to_write=text.get(1.0, 'end-1c')
    file=filedialog.asksaveasfile(initialdir='/Users/andypukhalyk/Desktop/here', defaultextension='.txt', filetypes=(('text files', '*.txt'),('docx', '*.docx')))
    window.destroy()
    if file:
        file.write(text_to_write)
        file.close()
window = Tk()
text = Text(window)
text.pack()
Button(window, text='Save', command=done).pack()
window.mainloop()

仅保留initialdir的正常代码：

filedialog.asksaveasfile(initialdir='/Users/andypukhalyk/Desktop/here')

现象 #

同时指定initialdir、defaultextension、filetypes参数时，保存对话框默认路径为iCloud的Documents目录，而非指定的/Users/andypukhalyk/Desktop/here；但仅保留initialdir参数时，默认路径符合预期。

原因 #

这是macOS系统下Tkinter文件对话框的特性问题：Tk在macOS上调用的是系统原生的NSSavePanel（保存对话框），当指定filetypes参数后，系统会优先根据文件类型的关联设置，选择最近使用的文件目录或系统预设的文档存储位置（比如iCloud Documents），从而覆盖了initialdir的指定路径。

解决方法 #

1. 确保目标路径存在 #

如果指定的initialdir路径不存在，Tk会自动 fallback 到系统默认路径。可以先检查并创建目标路径：

import os
from tkinter import *
from tkinter import filedialog

def done():
    target_dir = '/Users/andypukhalyk/Desktop/here'
    # 检查路径是否存在，不存在则创建
    if not os.path.exists(target_dir):
        os.makedirs(target_dir)
    
    text_to_write=text.get(1.0, 'end-1c')
    file=filedialog.asksaveasfile(
        initialdir=target_dir,
        defaultextension='.txt',
        filetypes=(('text files', '*.txt'),('docx', '*.docx'))
    )
    window.destroy()
    if file:
        file.write(text_to_write)
        file.close()

window = Tk()
text = Text(window)
text.pack()
Button(window, text='Save', command=done).pack()
window.mainloop()

2. 搭配initialfile参数 #

添加initialfile指定默认文件名，引导系统优先使用指定的初始路径：

file=filedialog.asksaveasfile(
    initialdir='/Users/andypukhalyk/Desktop/here',
    initialfile='untitled.txt',  # 指定默认文件名
    defaultextension='.txt',
    filetypes=(('text files', '*.txt'),('docx', '*.docx'))
)

3. 改用asksaveasfilename手动处理文件 #

先通过asksaveasfilename获取保存路径，再手动打开文件写入，这种方式对initialdir的兼容性更好：

from tkinter import *
from tkinter import filedialog

def done():
    text_to_write=text.get(1.0, 'end-1c')
    file_path = filedialog.asksaveasfilename(
        initialdir='/Users/andypukhalyk/Desktop/here',
        defaultextension='.txt',
        filetypes=(('text files', '*.txt'),('docx', '*.docx'))
    )
    window.destroy()
    if file_path:
        with open(file_path, 'w') as f:
            f.write(text_to_write)

window = Tk()
text = Text(window)
text.pack()
Button(window, text='Save', command=done).pack()
window.mainloop()

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