企业官网建设流程全解析

• 后端

glog（Google Logging Library）作为 C++14 实现的流式日志库，其输出行为的控制核心集中在一组可配置的 flag 上。本指南以仓库 docs/flags.md 为骨架，系统讲解 glog 三大输出调优手段：命令行参数、环境变量以及程序内FLAGS_*全局变量，并深入 src/flags.cc 与 src/logging.cc 源码，说明每个 flag 在底层如何影响日志的写入路径。读完本文，你将能够在真实项目中按需把日志切到 stderr、控制输出级别、指定日志目录，并利用--v/--vmodule精确调节 verbose 日志粒度。

控制 glog 输出的三种途径总览

glog 的 flag 体系设计成"一条数据、三种入口"：

1. 命令行参数：在系统装有 Google gflags 库时，构建系统自动探测并启用，可用--flag=value形式传参（见 CMakeLists.txt 中find_package (gflags 2.2.2)的检测逻辑）；
2. 环境变量：无论是否安装 gflags，都可以用GLOG_前缀的环境变量设置 flag（定义见 src/base/commandlineflags.h 的GLOG_DEFINE_*宏族）；
3. 程序内全局变量：直接读写FLAGS_*全局变量，多数 flag 修改后立即生效。

值得注意的是，即使安装了 gflags，环境变量路径依然有效：GLOG_DEFINE_*宏会在定义阶段读取GLOG_<name>环境变量作为初始值，而命令行 flag 一旦显式给出则覆盖环境变量（src/base/commandlineflags.h 注释明确：flag 优先级高于环境变量）。

途径一：命令行参数（依赖 gflags 库）

启用前提与自动检测

如果机器上安装了 Google gflags 库，构建系统会自动检测并启用。从源码看：

• CMake 侧通过find_package (gflags 2.2.2)检测，命中后设置HAVE_LIB_GFLAGS并给库添加GLOG_USE_GFLAGS编译定义（CMakeLists.txt 与 CMakeLists.txt）；
• 头文件侧，GLOG_USE_GFLAGS定义时直接引入<gflags/gflags.h>（src/glog/flags.h）。

一旦启用，就可以在启动程序时直接传参：

./your_application --logtostderr=1

效果：所有日志输出到stderr，不再写入日志文件。该行为在 src/logging.cc 的SendToLog()中得到印证——FLAGS_logtostderr或FLAGS_logtostdout为真时，消息直接走 stderr/stdout 写入分支，跳过文件落盘。

布尔 flag 的取值语法

glog 对布尔 flag 提供了宽松的写法：

• 置true：1、true、yes（大小写不敏感）；
• 置false：0、false、no（大小写不敏感）。

在实现层面，BoolFromEnv与EnvToBool宏只检查首字符是否为t/T/y/Y/1之一（src/flags.cc 与 src/base/commandlineflags.h），因此YES、True、1均视为真，其余视为假。

途径二：环境变量（无需 gflags）

未安装 gflags 时，命令行参数解析不可用，但环境变量始终可用。规则：flag 名加GLOG_前缀，全部大写。例如：

GLOG_logtostderr=1 ./your_application

等价于命令行--logtostderr=1，效果同样是"日志全部打到 stderr 而非文件"。

环境变量 → flag 的底层映射：每个 flag 的定义都经由GLOG_DEFINE_bool/int32/uint32/string宏，这些宏在定义时调用EnvToBool/EnvToInt/EnvToUInt/EnvToString读取同名GLOG_环境变量作为初始默认值（src/base/commandlineflags.h）。也就是说，环境变量设置的是 flag 的"出生默认值"，而命令行参数在运行时覆盖它。

特殊环境变量：除GLOG_*外，还有三个影响默认值的变量：

• GOOGLE_LOGTOSTDERR：logtostderr的默认来源（src/flags.cc）；
• GOOGLE_ALSOLOGTOSTDERR：alsologtostderr的默认来源（src/flags.cc）；
• GOOGLE_LOGTOSTDOUT：logtostdout的默认来源（src/flags.cc）；
• GOOGLE_TIMESTAMP_IN_LOGFILE_NAME：控制日志文件名是否带时间戳（src/flags.cc）；
• GOOGLE_LOG_DIR、TEST_TMPDIR：log_dir默认目录的候选来源（src/flags.cc 的DefaultLogDir()，依次取第一个非空者）。

核心 flag 速查表

以下为 docs/flags.md 中列出的最常用 flag，附源码默认值与语义：

严重级别数值对照

severity 与数值的对应关系贯穿整个 flag 体系（INFO=0、WARNING=1、ERROR=2、FATAL=3）：

• stderrthreshold=2意味着ERROR及以上会额外回显到 stderr；
• minloglevel=1意味着只有WARNING及以上才会真正被记录。

该数值体系定义于 src/glog/log_severity.h，并被 src/logging.cc（severity >= FLAGS_stderrthreshold）与 src/logging.cc（severity_ < FLAGS_minloglevel时跳过）两处消费，分别实现"阈值回显"与"阈值抑制"。

常用 flag 的进阶组合示例

# 全部日志走 stderr（调试/容器场景常用） ./your_application --logtostderr=1 # 只把 WARNING 及以上写日志文件，其余丢弃 ./your_application --minloglevel=1 # ERROR 及以上额外回显 stderr（默认即如此，可显式声明） ./your_application --stderrthreshold=2 # 指定日志目录并开启 INFO 级 verbose ./your_application --log_dir=/var/log/myapp --v=1

途径三：程序内动态修改FLAGS_*

除了启动期配置，glog 允许在代码中直接读写FLAGS_*全局变量。大部分 flag 赋值后立即生效；唯一的例外是与日志目标文件相关的 flag——例如FLAGS_log_dir，这类设置必须在google::InitGoogleLogging之前完成。

LOG(INFO) << "file"; // 多数 flag 更新后立即生效 FLAGS_logtostderr = 1; LOG(INFO) << "stderr"; FLAGS_logtostderr = 0; // 注意：这不会改变日志目标。若想设置它， // 必须在 google::InitGoogleLogging 之前完成。 FLAGS_log_dir = "/some/log/directory"; LOG(INFO) << "the same file";

为什么 log_dir 必须提前设置

FLAGS_log_dir在InitGoogleLogging阶段被读取并构建各 severity 的日志目标目录列表（src/logging.cc），此后文件目标已经创建并绑定到既有目录。因此运行时再修改log_dir，已经创建的目标不会迁移到新目录，这段代码才会输出"the same file"。这也解释了文档中的告诫：目标文件类 flag 应在初始化前设定。

声明 FLAGS_* 的正确姿势

在自定义模块中引用这些变量时，应通过公开头文件 src/glog/flags.h 中的DECLARE_bool/int32/uint32/string宏（如DECLARE_bool(logtostderr);、DECLARE_string(log_dir);）而非手写extern。这是 glog 刻意设计的隔离机制：flag 被放入fLB/fLI/fLU/fLS命名空间，强制使用者走DECLARE_*宏引入，从而保证类型一致性（src/base/commandlineflags.h 的注释解释了这一设计动机）。

--v与--vmodule：verbose 日志的精调

全局 verbose 级别：v

./your_application --v=2

• 显示所有VLOG(m)且m <= 2的消息；
• 默认值0，VLOG(0)默认开启，VLOG(1)默认关闭；
• VLOG的数值方向与 severity相反：severity 是"级别越高越严重、minloglevel越高越少输出"，而 VLOG 是"数值越小越容易输出"（docs/logging.md 中有专门警告说明这一反直觉设计）。

底层实现：VLOG_IS_ON(n)展开为对静态SiteFlag的一次懒初始化，命中时调用InitVLOG3__决定该调用点受FLAGS_v还是模块级 override 控制（src/glog/vlog_is_on.h）。

按模块覆盖：vmodule

./your_application --vmodule=mapreduce=2,file=1,gfs*=3 --v=0

vmodule接受逗号分隔的<module name>=<log level>列表：

• <module name>是 glob 模式，匹配文件名基底（去掉.cc/.h/-inl.h后缀后的名字），例如gfs*匹配所有以gfs开头的模块；
• <log level>覆盖--v的全局值；
• 通配符支持*（匹配 0 或多个字符）与?（匹配任意单个字符）。

以上命令的精确效果：

1. mapreduce.{h,cc}中VLOG(2)及更低的消息打印；
2. file.{h,cc}中VLOG(1)及更低的消息打印；
3. 所有以gfs前缀命名的文件中VLOG(3)及更低的消息打印；
4. 其余模块按--v=0，即VLOG(0)及更低打印。

源码佐证：vmodule在首次 VLOG 调用时被解析成VModuleInfo链表（src/vlog_is_on.cc 的VLOG2Initializer()），文件名基底计算时同时处理了-inl后缀裁剪（src/vlog_is_on.cc）；glob 匹配由不分配内存的SafeFNMatch_实现，仅支持*与?两种通配符（src/vlog_is_on.cc）。

运行时动态调整：SetVLOGLevel

vmodule不仅在启动期可用，还可以在程序运行中通过google::SetVLOGLevel(const char* module_pattern, int log_level)动态调节，它返回该模块之前应用的级别（src/vlog_is_on.cc）。测试用例EXPECT_EQ(0, SetVLOGLevel("logging_unittest", 1));印证了这一接口的行为（src/logging_unittest.cc）。注意：若要覆盖已经执行过的 VLOG 调用点，需要传入当初生效的确切--vmodule模式（src/glog/vlog_is_on.h）。

更完整的 flag 清单：探索 src/flags.cc

文档指出，logtostderr、stderrthreshold、minloglevel、log_dir、v、vmodule只是最常用的一小部分。完整的 flag 定义集中在 src/flags.cc，公开声明在 src/glog/flags.h。按类别速览：

输出目标与格式类

• logtostdout（bool，默认false）：日志写stdout而非文件；
• alsologtostderr（bool，默认false）：写文件的同时额外写 stderr（已被stderrthreshold取代，见源码注释）；
• colorlogtostderr/colorlogtostdout（bool，默认false）：终端支持时对 stderr/stdout 输出着色；
• log_file_header（bool，默认true）：每个日志文件开头是否写入文件头；
• log_prefix（bool，默认true）：每行日志是否带前缀；
• log_year_in_prefix（bool，默认true）：前缀中是否包含年份；
• log_utc_time（bool，默认false）：日志时间是否用 UTC；
• timestamp_in_logfile_name（bool，默认true）：日志文件名是否追加时间戳；
• logfile_mode（int32，默认0664）：日志文件权限位。

缓冲与滚动类

• logbuflevel（int32，默认0）：此级别及更低的消息缓冲，更高立即 flush；
• logbufsecs（int32，默认30）：消息最多缓冲多少秒；
• max_log_size（uint32，默认1800，单位 MB）：日志文件近似最大尺寸，0 会被强制改写成 1（src/logging.cc 的SafelyGetMaxLogSize）；
• logcleansecs（int32，默认300）：每 5 分钟清理一次过期日志（与 docs/log_cleaner.md 的清理机制配合）；
• stop_logging_if_full_disk（bool，默认false）：磁盘满时停止向磁盘写日志（src/logging.cc 处消费）；
• Linux 下还有drop_log_memory（bool，默认true）：flush 后立即从内存丢弃日志缓冲。

其他高级类

• log_backtrace_at（string，默认""）：在file:linenum处触发回溯输出；
• symbolize_stacktrace（bool，默认true）：在 tombstone 中符号化栈回溯；
• alsologtoemail/logemaillevel/logmailer：邮件告警相关（logemaillevel默认999，即几乎不发邮件）。

日志文件命名与默认目录的关系

log_dir的默认值来自DefaultLogDir()，依次检查GOOGLE_LOG_DIR、TEST_TMPDIR环境变量，均为空则返回""表示使用系统默认目录（src/flags.cc）。默认目录的选取规则详见 docs/logging.md：非 Windows 平台依次取TMPDIR、TMP，兜底/tmp/；Windows 平台用GetTempPathA，兜底C:\TMP\、C:\TEMP\。

日志文件名的最终格式为：

<tmp>/<program name>.<hostname>.<user name>.log.<severity>.<date>-<time>.<pid>

例如：

/tmp/hello_world.example.com.hamaji.log.INFO.20080709-222411.10474

结合--log_dir=/var/log/myapp即可把这类文件定向到业务目录，便于日志采集与轮转。

综合实战：一份可直接套用的调优模板

把三种途径组合起来，可以得到一份覆盖开发、测试、生产三种场景的模板：

# 开发调试：全量日志上 stderr，INFO 级别 verbose 全开 ./your_application --logtostderr=1 --v=1 # 容器/CI：同样走 stderr，但只保留 WARNING 以上，避免日志刷屏 GLOG_logtostderr=1 GLOG_minloglevel=1 ./your_application # 生产：指定目录、限定单个文件大小、磁盘满自动停写 ./your_application --log_dir=/var/log/myapp \ --max_log_size=500 \ --stop_logging_if_full_disk=1 # 生产 + 按模块降噪：主逻辑保持 INFO，只把 network 模块调到 WARNING 级 verbose ./your_application --v=1 --vmodule=network=0

对应地，程序内动态控制常与上述启动参数配合：启动期用命令行/环境变量定"目标文件类"flag（log_dir等），运行期再用FLAGS_*微调"即时生效类"flag（logtostderr、minloglevel、v等），并通过SetVLOGLevel做模块级热调整。验证手段可参考 src/logging_unittest.cc 中对FLAGS_logtostderr、FLAGS_v、FLAGS_stderrthreshold的组合读写测试（如 src/logging_unittest.cc、src/logging_unittest.cc）。

结语

glog 的输出调优并不复杂：一套 flag 定义（src/flags.cc），三种注入途径（命令行、GLOG_环境变量、FLAGS_*全局变量），两条核心规则（布尔值的宽松解析、目标文件类 flag 须先于InitGoogleLogging设置）。理解v/vmodule与 severity 体系在数值方向上的相反语义，就能精准驾驭从"静默"到"全量"的每一档输出粒度。更多细节可继续阅读 docs/logging.md 中的 verbose 章节与 docs/flags.md 原文。

• 后端