一个工具在开发机上跑得好好的,发给同事就出问题:双击快捷方式,弹出「找不到 config.ini」;桌面上显示的图标是一张白纸;任务管理器里程序的名字是 app.exe,版本信息一片空白。更奇怪的是,同样的 exe 放在桌面打开就正常,放进 Program Files 就写不进配置。

这几个现象看起来不相干,其实都指向同一个问题:程序对自己「在哪、往哪写、带不带资源」没有明确假设。桌面程序和命令行脚本最大的区别之一,就是你不能指望用户从 exe 所在目录启动它。这篇就把路径、资源和本地数据这三件事一次讲清楚。

工作目录不是 exe 目录

第一次遇到「找不到配置文件」的人,通常会打开任务管理器看进程,发现 exe 明明在 D:\Tools\RenameTool\,代码里写的却是相对路径 config.ini。程序没有错,相对路径本来就是相对于「当前工作目录」,而工作目录由启动它的进程决定。

从桌面快捷方式启动时,工作目录常常是 C:\Windows\System32(快捷方式没设置「起始位置」时的默认值);从「开始菜单」搜索启动、从别的程序里 ShellExecute 调起,工作目录也各不相同。于是 config.ini 被解析到 C:\Windows\System32\config.ini,当然找不到;写入时更没有权限。

相对路径是怎么跑偏的
用户双击快捷方式起始位置留空,系统给一个默认值
工作目录定了可能是 System32,也可能是桌面
代码读 config.ini按工作目录拼路径
结果找不到文件其实在 exe 旁边

正确的做法是用 GetModuleFileNameW 拿到 exe 的完整路径,再取它的父目录:

std::wstring exe_dir() {
    wchar_t buf[MAX_PATH]{};
    GetModuleFileNameW(nullptr, buf, MAX_PATH);
    return std::filesystem::path(buf).parent_path().wstring();
}

所有「随程序一起发布」的文件——默认配置、模板、帮助文档、图标、DLL——都应该基于这个目录去找,而不是基于工作目录。用户从哪里启动程序,都不影响它找到自己的同伴。

MAX_PATH 是 260 个字符的老限制。路径可能更长时,应该用 GetModuleFileNameW 的扩容写法,或者直接用 std::filesystem::path 配合 \\?\ 前缀。小工具可以先用 MAX_PATH,但别把「路径一定很短」写进假设。

顺便说清快捷方式的「起始位置」到底影响什么:它设置的是子进程的当前工作目录,不是 exe 路径。手动新建快捷方式时这一栏常常留空,Windows 就按默认规则给一个值;安装包创建的快捷方式一般会显式填上安装目录,所以同一个程序「从桌面快捷方式启动」和「从资源管理器双击 exe」表现可能不同。排查时先把这两种启动方式都试一遍,不要一上来就怀疑代码。

配置该写到哪里

「程序目录」适合放只读资源,不适合放用户数据。原因有两个:装到 Program Files 后,普通用户对那个目录没有写权限;多用户共用一台机器时,每个用户的配置会互相覆盖。

Windows 给出的惯例是按用途分三个位置:

安装目录exe、DLL、默认配置、模板。只读,随安装包更新。不要在这里写用户数据。
用户数据目录%LOCALAPPDATA% 或 %APPDATA%。每个用户一份,可写,适合配置、缓存、日志、本地数据库。
临时目录%TEMP%。随时可能被系统清理,只放导出中间文件、崩溃转储这类可丢弃的东西。

LOCALAPPDATA 和 APPDATA 的区别在于是否跟随用户漫游。配置和缓存放 LOCALAPPDATA 更稳妥,尤其是体积大的数据;APPDATA 在域环境里可能被同步到服务器,放个几百 MB 的缓存上去会拖垮登录。

便携版是另一种约定:配置就放在 exe 旁边,整个目录拷走就能带走。这时要先探测「exe 目录是否可写」,可写就用本地配置,不可写再退回用户目录。不要一边宣称绿色版,一边把数据写进注册表。

探测可写不要用「试着写一下再删掉」这种土办法,至少要把失败当成正常分支处理:写失败就切到用户目录,并在设置界面里显示当前用的是哪一份配置。用户换机器、换权限时,这个提示能省掉很多「我的设置怎么没了」的追问。

第一次运行时,用户目录里通常还没有配置。稳妥的流程是:先看用户目录有没有配置文件,没有就从安装目录复制一份默认配置过去,再打开使用。不要反过来「读不到就用代码里的硬编码默认值」,那样以后想改默认值就得改代码、重新发版。默认配置作为只读资源随安装包发布,用户配置作为可写副本存在用户目录,两者职责分开。

日志和缓存也按同样原则分。日志写 %LOCALAPPDATA% 下的 logs 子目录,方便用户打包发给你排查;缓存写 %LOCALAPPDATA% 下的 cache,可以随时删除;导出的中间文件写 %TEMP%,程序退出时尽量清理。把这几类东西混在一个目录里,时间一长就没人敢删了。

资源、图标与版本信息

Windows 的 exe 可以内嵌资源:图标、版本信息、字符串表、对话框模板、甚至任意二进制文件。资源通过 .rc 脚本描述,编译成 .res 后链接进 exe。MinGW 用 windres,MSVC 用 rc.exe,脚本本身是同一套语法。

先看版本信息,这是「程序看起来正不正规」的第一道门面:

1 VERSIONINFO
FILEVERSION 1,2,3,4
PRODUCTVERSION 1,2,3,4
FILEOS 0x40004
FILETYPE 0x1
BEGIN
  BLOCK "StringFileInfo"
  BEGIN
    BLOCK "080404b0"
    BEGIN
      VALUE "CompanyName", "科设工作室"
      VALUE "FileDescription", "资源验证程序"
      VALUE "FileVersion", "1.2.3.4"
      VALUE "ProductName", "ResLab"
      VALUE "ProductVersion", "1.2.3.4"
    END
  END
  BLOCK "VarFileInfo"
  BEGIN
    VALUE "Translation", 0x804, 1200
  END
END

几个字段值得解释。FILEVERSION 是四个用逗号分隔的数字,不能写点号;FILEOS 0x40004 表示 Win32,FILETYPE 0x1 表示应用程序。字符串块名 080404b0 拆开看是语言 0x0804(简体中文)加代码页 0x04b0(也就是十进制的 1200,代表 Unicode);下面对应的 Translation 也是 0x804, 1200。这两处必须一致,否则资源管理器可能读不到这一段。

编译要分两步:先把脚本编成二进制资源,再把它当成输入文件链进 exe。本机用 MSVC:rc /c 65001 version.rc,然后 cl /std:c++20 /utf-8 reslab.cpp version.res user32.lib。两个编码参数都不能省——/c 65001 告诉 rc 源文件是 UTF-8,否则中文的公司名会按本地代码页解释;/utf-8 告诉 cl 源码编码。MinGW 那一套是 windres version.rc -O coff -o version.res 再 g++ -std=c++20 reslab.cpp version.res -o reslab.exe,脚本语法相同,工具名和参数不同。

这一步之后,exe 是 174.5 KB。用 PowerShell 把版本信息读回来,本机实测输出:

(Get-Item .\reslab.exe).VersionInfo | Select-Object FileVersion,ProductVersion,FileDescription,ProductName,CompanyName

FileVersion     : 1.2.3.4
ProductVersion  : 1.2.3.4
FileDescription : 资源验证程序
ProductName     : ResLab
CompanyName     : 科设工作室

这五行和脚本里写的完全对应,说明资源真的进了 exe,而不是被链接器无声丢掉。如果这里一片空白,先查链接命令行里有没有 version.res,再查 rc 是否真的生成了 .res 文件——这两步都不会报错,只是不生效。

图标同理,在同一个 .rc 里加一行:

1 ICON "app.ico"

资源 ID 用 1 是因为资源管理器会挑编号最小的图标作为 exe 的显示图标。本机把图标编进去后,用资源查看工具能从 exe 里提取出 32×32 的那一档,说明图标确实写进了资源节,而不是只在源代码里出现。

.ico 文件本身要含多个尺寸:16、32、48,有条件再加 256。只放一张 256×256,任务栏和资源管理器会把它缩小,边缘发糊;只放一张 16×16,放大到桌面图标就糊成一团。Windows 不会替你生成中间尺寸,它只会从现有档位里挑最接近的一个。

代码里创建窗口时把图标挂上去:

wc.hIcon = LoadIconW(wc.hInstance, MAKEINTRESOURCEW(1));

很多人只改了 exe 的图标,却忘了窗口标题栏和任务栏还是默认图标。这两个是不同位置:exe 图标由资源决定,窗口图标由 WNDCLASSW::hIcon 和 WM_SETICON 决定,都要设置才一致。

本机这个资源实验程序的窗口标题是「资源验证」,正好可以拿来对照:标题来自代码里传给 CreateWindowExW 的字符串,版本信息里的 FileDescription 是「资源验证程序」,两者是两套机制,改一个不会影响另一个。

除了图标和版本,.rc 还能把任意文件嵌进去。比如把默认配置作为 RCDATA 资源打包,程序运行时用 FindResourceW / LoadResource 取出来,写到用户目录。这样安装包里只需要一个 exe,不会出现「用户把 ini 删了」的问题:

2 RCDATA "default.ini"

读取时先 FindResourceW(hInstance, MAKEINTRESOURCEW(2), RT_RCDATA),再 LoadResource 和 LockResource,配合 SizeofResource 拿到内存块。整个过程不依赖工作目录,也不怕用户误删。

这里有一个容易踩的假设:LockResource 返回的指针只在你把资源当只读数据用时才安全,不要强转成可写指针去改内容。资源在 exe 里是只读映射,改它轻则访问冲突,重则把整个进程弄崩。需要可变副本就自己拷一份到堆上,用 SizeofResource 的长度拷贝。

还有一点:RCDATA 适合放文本、模板、小图标这类静态内容,不适合放几百 MB 的数据库。资源会整体映射进进程地址空间,文件越大,启动时的映射开销越明显,而且每次更新内容都得重新编 exe。大文件还是留在 exe 旁边或用户目录里更合适。

资源 ID 是整数,1、2 这种裸数字很容易和别的资源撞。团队里通常定义 resource.h 统一管理,或者用字符串 ID。改图标后如果资源管理器还显示旧图标,那是图标缓存,不是链接失败,重启资源管理器或清缓存再验证。

中文路径与宽字符

Windows 有两套 API:...A 结尾的走 ANSI 编码,...W 结尾的走 UTF-16。中文用户名、中文目录名在 ANSI 接口下会出现乱码或找不到文件,因为 ANSI 代码页不一定覆盖这些字符。规则很简单:新代码一律用 ...W 接口。

MinGW 和 MSVC 都支持在源码里直接写中文,但源文件要存成 UTF-8,并且让编译器知道。MSVC 需要 /utf-8,MinGW 默认按 UTF-8 处理。字符串字面量前加 L 得到宽字符版本,比如 L"配置"。

C++17 之后,std::filesystem::path 和 std::ifstream 可以直接接受 std::filesystem::path,在 Windows 上内部走宽字符接口。也就是说,只要路径对象是从宽字符构造出来的,中文路径就不会出问题:

auto config = exe_dir_path / L"默认配置.ini";
std::ifstream in(config, std::ios::binary);   // 不需要 .string() 转换

反过来,如果你先调用 .string() 把路径转成窄字符串,再传给 std::ifstream 的 const char* 构造,就走回了 ANSI 路径,中文会坏。这是很隐蔽的一步,代码看起来只是「转成字符串」,实际上把编码信息丢了。

控制台输出也要单独处理。程序用 printf 打印 %ls 时,能否正确显示中文取决于控制台的代码页。加一句 SetConsoleOutputCP(CP_UTF8) 并让终端使用 UTF-8 字体,通常能解决乱码;这只是调试输出的问题,不影响文件读写本身。图形界面程序没有控制台,调试信息更适合写日志文件。

还有一层:即便代码页设成了 UTF-8,字体也得支持中文。默认点阵字体对中文覆盖很差,换成支持中文的等宽字体才能正常显示。这类问题只影响调试输出,不影响文件本身,但会让人误判「程序把中文写坏了」。

一次完整的实测走查

下面这个程序把三件事串起来:打印 exe 目录、当前工作目录、用户数据目录;在用户数据目录下建子目录、写配置、再读回来。完整可编译:

#include <windows.h>
#include <cstdio>
#include <filesystem>
#include <fstream>
#include <string>

std::wstring exe_dir() {
    wchar_t buf[MAX_PATH]{};
    GetModuleFileNameW(nullptr, buf, MAX_PATH);
    return std::filesystem::path(buf).parent_path().wstring();
}

std::wstring local_app_data() {
    wchar_t buf[MAX_PATH]{};
    GetEnvironmentVariableW(L"LOCALAPPDATA", buf, MAX_PATH);
    return buf;
}

bool write_text(const std::filesystem::path& path, const std::string& text) {
    std::ofstream out(path, std::ios::binary);
    if (!out) return false;
    out.write(text.data(), static_cast<std::streamsize>(text.size()));
    return out.good();
}

int main() {
    std::wstring exe = exe_dir();
    std::wstring cwd = std::filesystem::current_path().wstring();
    std::wstring local = local_app_data();

    std::printf("exe dir : %ls\n", exe.c_str());
    std::printf("cwd     : %ls\n", cwd.c_str());
    std::printf("localapp: %ls\n", local.c_str());

    auto data_dir = std::filesystem::path(local) / L"RenameTool";
    std::filesystem::create_directories(data_dir);
    auto config = data_dir / L"config.ini";

    bool ok = write_text(config, "last_dir=\nfont_size=14\n");
    std::printf("write   : %s -> %ls\n", ok ? "ok" : "failed", config.c_str());
    std::printf("exists  : %s\n", std::filesystem::exists(config) ? "yes" : "no");

    std::ifstream in(config, std::ios::binary);
    std::string line;
    while (std::getline(in, line)) {
        std::printf("read    : %s\n", line.c_str());
    }
    return 0;
}

编译后,故意从 C:\Windows\System32 这个目录启动它,模拟快捷方式没设起始位置的情况:

g++ -std=c++20 paths.cpp -o paths.exe
cd C:\Windows\System32
D:\Tools\RenameTool\paths.exe

本机实测输出(验证时把 LOCALAPPDATA 指向了临时目录,避免动到真实用户目录;路径解析逻辑没有改):

exe dir : C:\Users\c1805\AppData\Local\Temp\desktop-test
cwd     : C:\Windows\System32
localapp: C:\Users\c1805\AppData\Local\Temp\fake-local
write   : ok -> C:\Users\c1805\AppData\Local\Temp\fake-local\RenameTool\config.ini
exists  : yes
read    : last_dir=
read    : font_size=14

三行路径把问题说清楚了:exe dir 是程序真正所在的位置,cwd 是启动时的工作目录,两者可以完全不同;localapp 才是写用户数据的地方。配置写进去之后,再用 ifstream 读回来,中文路径同样适用——这段代码没有做任何编码转换,靠的是 std::filesystem::path 在 Windows 上走宽字符。

验证时用的是临时目录,不是真实的 AppData\Local。这提醒一件事:程序里不要把用户目录写死,读 LOCALAPPDATA 环境变量或系统 API 才对;不同机器、不同用户、不同权限下,这个位置会变。

出问题时先看哪里

现象真实原因第一步查什么
快捷方式启动找不到配置文件用了相对路径,工作目录不是 exe 目录在程序里同时打印 exe_dir() 和 current_path(),对比两者
装到 Program Files 后写配置失败普通用户对安装目录没有写权限把写入位置改到 %LOCALAPPDATA%,并处理 create_directories 的失败返回值
exe 图标是白纸.rc 没编译、没链接,或资源 ID 不是最小的那个用资源查看工具打开 exe,确认图标资源是否存在,再核对 windres 的输入文件
属性里版本信息全空只链接了代码,没有把 .res 加进链接命令检查链接命令行里有没有 version.res,再用 PowerShell 读 VersionInfo
中文目录下的文件读不到用了 ANSI 接口,或把 path 转成了窄字符串确认调用的是 ...W API,路径对象没有经过 .string()
改完图标资源管理器还显示旧的Windows 图标缓存没刷新换一个文件名或目录再试,排除缓存干扰后再判断资源是否真的编进去了
配置写成功但重启后回到默认写到了临时目录,或程序读取的是另一个路径把「写入路径」和「读取路径」都打印出来,确认是同一个
覆盖 exe 时提示文件被占用旧进程还在运行,或杀毒软件正在扫描任务管理器确认进程已退出,再检查是否有后台常驻实例

边界与代价

第一,路径问题没有「一次写对,永远正确」的方案。安装版、便携版、多用户、漫游、长路径、网络盘,每种组合都可能改变「哪里可写、哪里能找到」。稳妥的做法是把路径解析集中到一个模块,所有地方都从它拿路径,而不是散落在各个 fopen 调用里。

第二,资源文件把构建拆成了两步。忘了编译 .rc,图标和版本信息就静默丢失,编译器不会提醒你。解决方式是把 windres 或 rc.exe 写进构建脚本,让资源成为构建的固定环节,而不是「发布前手工补一下」。

第三,UAC 和数据目录是两套机制。以管理员身份运行能让程序写 Program Files,但这不是正确做法:提权会带来安全风险和用户体验问题,而且普通用户下次不提权运行时配置又读不到。数据就该放数据目录,安装目录保持只读。

第四,文件锁和并发写是另一个话题。两个实例同时写同一个 ini,后写的覆盖先写的;写入过程中断电,文件可能只写了一半。下一篇升级与崩溃排查会讲原子写入,这里先记住:ofstream 打开成功不代表写入成功,good() 和 close() 的返回值都要看。

不要把用户数据写进注册表就算「省事」。注册表没有便携性,卸载残留难清理,调试时也不好备份。除非要和系统集成(文件关联、协议处理),配置优先用文件。

小结

三句话:exe 目录靠 GetModuleFileNameW 拿,不要靠工作目录;用户数据写 %LOCALAPPDATA%,不要写安装目录;图标和版本信息是 .rc 资源,必须编进链接命令里。

当天可以自己验证的练习:

  1. 把上面的程序从两个不同的工作目录启动,对比 cwd 那行的差异。
  2. 把 version.rc 里的 FileDescription 改掉,重新编译,用属性面板确认真变了。
  3. 在 exe 旁边放一个中文名文件,用 std::filesystem::path 读取,再把路径转成 .string() 试一次,观察差异。
  4. 把配置目录改成 exe 目录,装到 Program Files 下运行,确认写入失败并处理错误。
  5. 给窗口设置 hIcon,对比只改 exe 图标和同时改窗口图标的效果。

下一篇讲Qt 上手。Win32 这边,窗口、控件、资源都已经能自己搞定;但界面一旦复杂起来,手写坐标和消息分发就会拖慢进度。Qt 会把这三件事分别换成布局、信号槽和资源系统。