环境运维

在 Qt 项目中,如果不想在每个项目里手动添加 QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15(或其他 macOS 版本),

方法 1:在 qmake.conf 中全局设置(推荐)

Qt 的全局配置文件可以设置默认的 QMAKE_MACOSX_DEPLOYMENT_TARGET,适用于所有项目。

步骤

  1. 找到 Qt 的 qmake.conf 文件:

    bash

    Copy

    Download

    # 通常路径(Qt 5/6,具体路径可能因版本不同)
    /Users/你的用户名/Qt/6.5.0/macos/mkspecs/macx-clang/qmake.conf

    (替换 6.5.0 为你的 Qt 版本)

  2. 在 qmake.conf 末尾添加:

    makefile

    Copy

    Download

    QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15
  3. 保存文件后,所有使用该 Qt 版本的项目都会自动继承此配置。

优点

  • 一劳永逸,所有新项目无需额外设置。

  • 不影响已有项目,除非它们显式覆盖该值。

缺点

  • 修改 Qt 安装目录文件,可能影响其他项目(但通常安全)。


方法 2:在用户环境变量中设置

如果不想修改 Qt 安装文件,可以通过 ~/.zshrc(或 ~/.bashrc)设置环境变量,影响 qmake 行为。

步骤

  1. 编辑 ~/.zshrc(或 ~/.bashrc):

    bash

    Copy

    Download

    nano ~/.zshrc
  2. 添加:

    bash

    Copy

    Download

    export QMAKE_MACOSX_DEPLOYMENT_TARGET=10.15
  3. 使配置生效:

    bash

    Copy

    Download

    source ~/.zshrc

优点

  • 不修改 Qt 文件,仅影响当前用户。

  • 适用于所有 Qt 版本。

缺点

  • 如果其他用户或 CI 环境未设置,可能不生效。


方法 3:在 ~/.qmake.conf 中设置(用户级配置)

Qt 会读取用户目录下的 ~/.qmake.conf 文件,可以在此设置全局默认值。

步骤

  1. 创建或编辑 ~/.qmake.conf:

    bash

    Copy

    Download

    nano ~/.qmake.conf
  2. 添加:

    makefile

    Copy

    Download

    QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15
  3. 保存后,所有 qmake 项目会自动应用。

优点

  • 用户级配置,不影响系统其他用户。

  • 优先级高于 Qt 默认配置。

缺点

  • 如果项目显式设置了 QMAKE_MACOSX_DEPLOYMENT_TARGET,会覆盖此值。


方法 4:在 QT_PROJECT_FILE 中设置(项目模板)

如果使用 Qt Creator,可以修改项目模板,使新创建的项目自动包含该配置。

步骤

  1. 找到 Qt Creator 的项目模板(如 ~/Qt/Templates/project)。

  2. 修改模板的 .pro 文件,添加:

    makefile

    Copy

    Download

    QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15
  3. 之后新建的项目会自动包含该行。

优点

  • 适用于新项目,无需手动添加。

缺点

  • 不影响已有项目。


验证配置是否生效

在终端运行:

bash

Copy

Download

qmake -query QMAKE_MACOSX_DEPLOYMENT_TARGET

如果输出 10.15,说明配置已生效。


总结

方法 适用场景 优先级 备注
修改 qmake.conf 全局生效 低 需修改 Qt 安装目录
环境变量 ~/.zshrc 用户级 中 简单但依赖 Shell
~/.qmake.conf 用户级 高 推荐,不污染系统
Qt Creator 模板 新项目 项目级 仅影响新建项目

推荐 方法 3(~/.qmake.conf),既不影响系统,又能全局生效。如果仍有问题,可以检查项目是否显式覆盖了该值。