如何在mcc编译的Matlab独立可执行文件中嵌入构建时写入的全局变量

核心逻辑很简单：mcc会把编译阶段指定的所有代码、资源全部固化到独立可执行文件的内部运行缓存中，全程不需要运行时依赖Git仓库环境，所有需要的版本信息都在打包前提前提取、硬编码进待编译的代码里即可。

步骤1：构建阶段提取Git提交哈希 #

所有涉及Git命令的操作，只在构建机的代码仓库环境下执行，绝对不要放到最终用户运行的业务代码里：

• 编写独立的构建脚本（比如叫build_deploy.m），脚本首先在仓库根路径下调用系统命令拉取最新的提交哈希：

% 仅构建机运行的代码段
[gitStatus, gitOutput] = system('git rev-parse HEAD');
if gitStatus ~= 0
    error('构建终止：当前路径不是有效Git仓库，无法提取提交哈希');
end
commitHash = strtrim(gitOutput); % 清理输出里的换行、空白字符

• 可选：可以顺手提取当前分支名、工作区是否有未提交改动、最近提交时间等信息，一并存进变量，后续一起嵌进版本信息里。

步骤2：将commitHash固化为可执行文件内部的全局可访问值 #

这里用兼容性最好的实现方式：动态生成独立的常量M文件，让mcc在打包时把这个文件嵌进可执行程序内部。

• 拿到commitHash后，通过构建脚本自动生成版本常量文件（比如deploy_version.m），直接把哈希值硬编码进去：

% 构建脚本自动生成deploy_version.m文件的写入逻辑
fileId = fopen(fullfile(tempdir, 'deploy_version.m'), 'w');
fprintf(fileId, 'function versionStr = deploy_version()\n');
fprintf(fileId, "    versionStr = '%s';\n", commitHash);
fprintf(fileId, 'end\n');
fclose(fileId);

• 跑mcc编译命令时，把这个临时生成的deploy_version.m文件加入编译路径，一起打包：

% 构建脚本里的mcc调用命令
mcc -m main_app.m ... % 你的业务主程序
    -I tempdir ... % 把生成deploy_version.m的临时目录加入Matlab搜索路径
    -o my_deploy_app % 生成的可执行文件名

等mcc编译完成后，这个deploy_version函数就已经完全固化在可执行文件内部了，不管用户后续在哪个路径、什么环境下运行程序，只要调用deploy_version()就能拿到构建期写入的提交哈希，完全脱离Git环境。

步骤3：将提交哈希关联到所有输出文件 #

业务代码运行时不需要任何额外的Git操作，只需要在生成每个输出文件时，读取固化的版本值即可：

• 对Mat类输出文件（.mat）：把哈希值作为字段写入mat文件的元数据，后续读取时可以直接溯源对应的代码版本。
• 对文本类输出文件（.csv、.log、.json）：在文件头的注释行里写入提交哈希，不需要额外的解析工具就能查看版本。
• 对图像类输出文件：把哈希值写入图的标题、导出的元数据块里。
  举个业务代码里的示例：

% 被编译的业务主程序main_app.m
function main_app()
    % 读取编译期固化的版本值
    appVersion = deploy_version();

    % 示例1：生成mat结果文件
    calcResult = magic(10);
    save('calc_result.mat', 'calcResult', 'appVersion');

    % 示例2：生成csv结果文件
    fileHandle = fopen('calc_table.csv', 'w');
    fprintf(fileHandle, '# 生成自Git提交：%s\n', appVersion);
    fprintf(fileHandle, 'x,y\n');
    for rowIdx = 1:10
        fprintf(fileHandle, '%d,%d\n', rowIdx, magic(10, rowIdx));
    end
    fclose(fileHandle);
end

关键避坑提醒

• 绝对不要把调用Git命令的代码段放到被编译的业务主程序里，否则最终用户运行时因为没有Git环境、不在仓库路径下，必然报错。
• 不需要把.git目录作为附加资源打包进可执行文件，所有需要的信息已经提前提取为普通字符串，打包后可执行文件体积不会额外增加。
• 每次执行构建脚本时，重新覆盖生成deploy_version.m文件，避免引用到之前编译残留的旧版本信息。

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