c++oding="utf-8" ?>
推荐用 std::chrono::system_clock::now() 获取时间点,经 localtime_s(windows)或 localtime_r(linux/macos)转为本地 std::tm,再用 std::put_time 格式化写入文件,避免 utc 误用和线程安全问题。

用 std::chrono + std::put_time 获取本地时间并写入文件
标准 C++11 起,推荐用 std::chrono 获取高精度时间点,再转为 std::tm 格式化输出。注意:std::chrono::system_clock::now() 返回的是 UTC 时间点,需用 std::localtime(非线程安全)或 std::localtime_s(MSVC)/ std::localtime_r(POSIX)转成本地时区。
常见错误是直接对 system_clock::time_point 调用 std::gmtime 或忽略时区转换,导致写入文件的时间比实际晚 8 小时(如东八区显示成 UTC)。
- Windows 下优先用
std::localtime_s(&tm, &time_t_val)避免数据竞争 - Linux/macOS 用
std::localtime_r(&time_t_val, &tm) - 格式化必须用
std::put_time,不能用 C 风格strftime混合流操作(易出错)
#include <fstream>
#include <iostream>
#include <chrono>
#include <ctime>
#include <iomanip>
int main() {
auto now = std::chrono::system_clock::now();
auto time_t = std::chrono::system_clock::to_time_t(now);
std::tm tm{};
#ifdef _WIN32
std::localtime_s(&tm, &time_t);
#else
std::localtime_r(&time_t, &tm);
#endif
std::ofstream file("log.txt", std::ios::app);
file
<h3>用 <code>std::format</code>(C++20)更简洁安全地生成时间字符串</h3>
<p>C++20 引入 <code>std::format</code>,可直接格式化 <code>std::chrono::time_point</code>,无需手动转 <code>std::tm</code>,也规避了 <code>localtime</code> 系列函数的线程安全问题。但要注意:GCC 13+、Clang 15+、MSVC 19.32+ 才完整支持;且默认不支持时区自动转换——仍需先转为本地 <code>std::tm</code> 或用第三方库(如 Howard Hinnant’s date)。</p>
<ul>
<li>若已启用 C++20 且编译器支持,<code>std::format("{:%Y-%m-%d %H:%M:%S}", tm)</code> 比 <code>std::put_time</code> 更易读</li>
<li>不要写 <code>std::format("{:%Y-%m-%d}", now)</code>——<code>std::format</code> 对裸 <code>time_point</code> 的支持有限,会编译失败</li>
<li>写入文件前建议检查 <code>file.is_open()</code>,避免静默失败</li>
</ul>
<h3>跨平台写文件时的编码与换行问题</h3>
<p>时间字符串本身是 ASCII,但若后续要中文注释或路径含中文,<code>std::ofstream</code> 默认不处理 UTF-8。Windows 记事本打开无 BOM 的 UTF-8 文件会乱码,这是文件内容没错、只是查看器的问题。真正影响写入的是换行符:</p>
<ul>
<li>Linux/macOS 写 <code>"\n"</code> 即可;Windows 建议用 <code>"\r\n"</code>(尤其给 Excel 或旧工具读取)</li>
<li>不推荐用 <code>std::ofstream</code> 的 <code>std::ios::binary</code> 模式写文本——会禁用自动换行转换,反而让跨平台行为更难预测</li>
<li>如果日志量大,避免每条都开闭文件,应复用 <code>std::ofstream</code> 对象或用缓冲写入</li>
</ul>
<h3>用 <code>std::filesystem::last_write_time</code> 替代手动生成时间戳的场景</h3>
<p>如果你其实不需要“当前时间”,而是想记录某文件最后一次修改时间(比如备份脚本中打时间戳),别硬套 <code>system_clock::now()</code>——直接用 <code>std::filesystem::last_write_time(path)</code> 更准确,且天然带时区信息(返回 <code>file_time_type</code>,可转为 <code>sys_time</code> 后格式化)。</p>
<ul>
<li>注意 <code>std::filesystem</code> 需 C++17 且链接 <code>-lstdc++fs</code>(GCC)或启用 /std:c++17(MSVC)</li>
<li>该 API 返回的是文件系统原生时间,不受程序运行时区设置影响,比“取当前时间 + 拼文件名”更可靠</li>
<li>若目标是生成类似 <code>backup_20240520_143022.zip</code> 这种文件名,务必用 <code>std::put_time</code> 或 <code>std::format</code> 控制宽度(如 <code>%Y%m%d_%H%M%S</code>),避免空格或非法字符</li>
</ul>
写文件时最容易被忽略的是:时区转换函数的线程安全性、Windows/Linux 下 <code>localtime</code> 变体的差异、以及未检查文件流状态就写入——这三处任一出错都会导致日志为空或时间错乱,但程序不报错。</iomanip></ctime></chrono></iostream></fstream>C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











