在 Qt 项目中,如果不想在每个项目里手动添加 QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15(或其他 macOS 版本),
方法 1:在 qmake.conf 中全局设置(推荐)
Qt 的全局配置文件可以设置默认的 QMAKE_MACOSX_DEPLOYMENT_TARGET,适用于所有项目。
步骤
-
找到 Qt 的
qmake.conf文件:bash
Copy
Download
# 通常路径(Qt 5/6,具体路径可能因版本不同) /Users/你的用户名/Qt/6.5.0/macos/mkspecs/macx-clang/qmake.conf
(替换
6.5.0为你的 Qt 版本) -
在
qmake.conf末尾添加:makefile
Copy
Download
QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15
-
保存文件后,所有使用该 Qt 版本的项目都会自动继承此配置。
优点
-
一劳永逸,所有新项目无需额外设置。
-
不影响已有项目,除非它们显式覆盖该值。
缺点
-
修改 Qt 安装目录文件,可能影响其他项目(但通常安全)。
方法 2:在用户环境变量中设置
如果不想修改 Qt 安装文件,可以通过 ~/.zshrc(或 ~/.bashrc)设置环境变量,影响 qmake 行为。
步骤
-
编辑
~/.zshrc(或~/.bashrc):bash
Copy
Download
nano ~/.zshrc
-
添加:
bash
Copy
Download
export QMAKE_MACOSX_DEPLOYMENT_TARGET=10.15
-
使配置生效:
bash
Copy
Download
source ~/.zshrc
优点
-
不修改 Qt 文件,仅影响当前用户。
-
适用于所有 Qt 版本。
缺点
-
如果其他用户或 CI 环境未设置,可能不生效。
方法 3:在 ~/.qmake.conf 中设置(用户级配置)
Qt 会读取用户目录下的 ~/.qmake.conf 文件,可以在此设置全局默认值。
步骤
-
创建或编辑
~/.qmake.conf:bash
Copy
Download
nano ~/.qmake.conf
-
添加:
makefile
Copy
Download
QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15
-
保存后,所有
qmake项目会自动应用。
优点
-
用户级配置,不影响系统其他用户。
-
优先级高于 Qt 默认配置。
缺点
-
如果项目显式设置了
QMAKE_MACOSX_DEPLOYMENT_TARGET,会覆盖此值。
方法 4:在 QT_PROJECT_FILE 中设置(项目模板)
如果使用 Qt Creator,可以修改项目模板,使新创建的项目自动包含该配置。
步骤
-
找到 Qt Creator 的项目模板(如
~/Qt/Templates/project)。 -
修改模板的
.pro文件,添加:makefile
Copy
Download
QMAKE_MACOSX_DEPLOYMENT_TARGET = 10.15
-
之后新建的项目会自动包含该行。
优点
-
适用于新项目,无需手动添加。
缺点
-
不影响已有项目。
验证配置是否生效
在终端运行:
bash
Copy
Download
qmake -query QMAKE_MACOSX_DEPLOYMENT_TARGET
如果输出 10.15,说明配置已生效。
总结
| 方法 | 适用场景 | 优先级 | 备注 |
|---|---|---|---|
修改 qmake.conf |
全局生效 | 低 | 需修改 Qt 安装目录 |
环境变量 ~/.zshrc |
用户级 | 中 | 简单但依赖 Shell |
~/.qmake.conf |
用户级 | 高 | 推荐,不污染系统 |
| Qt Creator 模板 | 新项目 | 项目级 | 仅影响新建项目 |
推荐 方法 3(~/.qmake.conf),既不影响系统,又能全局生效。如果仍有问题,可以检查项目是否显式覆盖了该值。