硬编码（Hard Coding），也叫魔法数字（Magic Numbers），是指在程序中直接使用固定的字面值或特定字符串，而没有通过变量、常量、配置文件等方式定义或解释其含义。硬编码通常会导致代码的可读性、可维护性和扩展性变差。
1. 硬编码的特点
- 缺乏语义：硬编码的值没有附加说明或含义，其他开发者可能难以理解这些数字或字符串的用途。
- 不易修改：如果硬编码的值需要修改，就必须在多个地方手动更改，容易引入错误。
- 缺乏灵活性：硬编码的值通常无法适应变化的需求，例如用户自定义或配置调整。
2. 硬编码的示例
坏例子（硬编码）
#include <stdio.h>
int main() {
float radius = 5.0;
float area = 3.14159 * radius * radius; // 硬编码了圆周率
printf("Circle area:
return 0;
}在上面的代码中，3.14159 是一个硬编码的数字，虽然它是圆周率，但代码没有明确说明其含义，其他人可能难以理解。
好例子（使用常量）
#include <stdio.h>
#define PI 3.14159 // 使用宏定义常量，清晰表达含义
int main() {
float radius = 5.0;
float area = PI * radius * radius;
printf("Circle area:
return 0;
}通过定义常量 PI，代码的可读性大大提高。如果以后需要调整圆周率的值，只需修改常量的定义，而不必到代码中查找和替换所有出现的地方。
3. 硬编码的常见表现
- 使用未命名的数字（如
3.14159、100等）或字符串（如"username"）。 - 直接将路径、端口号或其他配置信息写死在代码中。
示例 1：硬编码路径
FILE *file = fopen("C:/data/input.txt", "r"); // 硬编码文件路径示例 2：硬编码配置信息
if (userAge > 18) { // 硬编码了年龄条件
printf("Adult user.\n");
}4. 如何避免硬编码
- 使用常量：将固定值提取为具名的常量。
- 使用配置文件：将可变数据存储在外部配置文件（如 JSON、YAML、INI）中。
- 使用命令行参数或环境变量：允许用户运行时动态设置参数。
示例 1：用常量代替硬编码
#define MAX_AGE 18
if (userAge > MAX_AGE) {
printf("Adult user.\n");
}示例 2：用配置文件代替硬编码
// 从配置文件读取
char configPath[] = "config.json"; // 配置文件路径示例 3：用命令行参数代替硬编码
int main(int argc, char *argv[]) {
if (argc < 2) {
printf("Usage:
return 1;
}
int age = atoi(argv[1]);
if (age > 18) {
printf("Adult user.\n");
}
return 0;
}5. 硬编码的危害
- 可读性差：其他开发者难以理解代码中某些固定值的意义。
- 难以维护：如果值需要修改，必须手动修改代码中所有地方。
- 易出错：重复出现的硬编码值容易导致遗漏或修改不一致。
- 不灵活：不能根据运行时条件动态调整，限制了程序的扩展性。
6. 总结
硬编码是编程中应该尽量避免的做法。通过使用常量、配置文件、命令行参数或环境变量，可以使代码更加灵活、易读、易维护。特别是系统的复杂度提升之后，如果不会对很多常量进行恰当的宏定义，代码的可维护性与移植性会变得很差，最后只能进行重构，耗费大量的时间与精力。