如何为Qt C++文本编辑器实现「打开方式」关联 支持右键打开文档

1. 应用内文件打开逻辑适配 #

系统通过「打开方式」启动你的程序时，会把待打开的文件绝对路径作为命令行参数传入程序，你需要在Qt代码里主动解析该参数：

• 在main函数中读取QCoreApplication::arguments()，列表下标0是程序自身路径，下标1及之后为传入的文件路径（支持多选打开多个文件时会有多个参数）
• 示例代码：

#include <QApplication>
#include <QMainWindow>
#include <QStringList>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;

    // 解析命令行参数
    QStringList args = QCoreApplication::arguments();
    if (args.size() >= 2) {
        // 取第一个传入的文件路径，支持多文件的话可以遍历args从1到末尾
        QString targetFilePath = args.at(1);
        // 调用你自己实现的文件打开方法
        w.openFile(targetFilePath);
    }

    w.show();
    return a.exec();
}

• 额外提示：如果需要实现单实例（打开多个文件不会重复启动程序），可以用Qt的QLocalServer+QLocalSocket实现进程间通信，把新的文件路径传给已启动的进程。

2. 不同平台的「打开方式」注册逻辑 #

需要把你的应用支持的文件类型、启动参数规则注册到系统中，才会出现在「打开方式」列表里，不同系统的注册逻辑不同：

Windows 平台 #

有两种实现方式：

• 安装程序注册：用Inno Setup、NSIS等安装包打包工具时，直接配置安装时写入注册表项：
  路径：HKEY_CURRENT_USER\Software\Classes\Applications\你的程序名.exe\shell\open\command
  项默认值："你的程序完整路径" "%1"
  其中%1是系统传入的待打开文件路径占位符，必须加双引号避免路径带空格时解析错误
• 程序运行时主动注册：可以在程序首次启动时调用Windows API写入上述注册表项，不需要管理员权限（写HKEY_CURRENT_USER路径下的表项不需要权限）

macOS 平台 #

只需要在程序的Info.plist配置文件中添加文档类型声明即可，Qt的.pro工程里可以直接配置该字段：

QMAKE_INFO_PLIST = Info.plist

在Info.plist中添加CFBundleDocumentTypes字段，声明支持的UTI（比如纯文本对应public.text）、文件后缀等信息，系统会自动识别并把你的应用加入对应文件的打开方式列表。

Linux 平台 #

需要编写.desktop桌面入口文件，放到~/.local/share/applications/（当前用户生效）或者/usr/share/applications/（全局生效，需要root权限），示例内容：

[Desktop Entry]
Type=Application
Name=你的文本编辑器名称
Exec=你的程序完整路径 %f
Icon=你的程序图标路径
MimeType=text/plain;text/markdown;

其中%f是文件路径占位符，MimeType字段填写你支持的所有文本类MIME类型，写完后执行update-desktop-database命令刷新系统缓存即可生效。

注意事项 #

• 所有平台的启动参数占位符都必须加双引号包裹，避免路径含空格、特殊字符时被拆分为多个参数，导致程序无法识别正确的文件路径
• 如果需要关联自定义后缀，只需要在对应平台的注册规则里添加对应的后缀、MIME类型即可

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