使用 map() 将数值映射到新范围
将原始读数重新缩放为实用单位
使用 map() 将数值映射到新范围 是 CoddyKit 上的免费 Arduino & IoT Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Arduino & IoT Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Arduino & IoT Academy 课程共包含 4 节课。
原始数值不够方便
0 到 1023 的读数通常并不是您真正需要的结果。很多时候，您需要的是百分比或角度，而不是原始传感器计数值。
认识 map 函数
map 函数会将一个范围内的数值按比例转换到另一个范围。它会替您完成比例计算。
它有五个参数
您需要为 map 提供五项内容：数值、当前范围的最小值和最大值，以及目标范围的最小值和最大值。
map(value, fromLow, fromHigh, toLow, toHigh);换算为百分比
要将旋钮转换为 0 到 100 的百分比，请将模拟范围映射到百分比范围。得到的结果就像音量旋钮的读数。
int pct = map(analogRead(A0), 0, 1023, 0, 100);换算为舵机角度
舵机的范围通常是 0 到 180。将旋钮映射到这个范围后，读数就会变成电机可使用的角度。
int angle = map(analogRead(A0), 0, 1023, 0, 180);它返回整数
map 函数使用整数运算，因此会返回整数并舍弃小数部分。对于大多数控制场景来说，这已经足够了。
您可以翻转范围
将目标范围的最小值设置得大于最大值，就能反转输出。这样，向右转动旋钮时，结果反而会减小。
int v = map(analogRead(A0), 0, 1023, 100, 0);它不会限制范围
如果输入超出范围，map 函数返回的结果也会超出目标边界。之后请使用 constrain，将结果安全地限制在边界之内。
int v = constrain(map(x,0,1023,0,100),0,100);负数范围同样适用
目标范围可以包含负数，例如用于居中控制的 -50 到 50。map 的计算可以直接处理这种方向，无需额外操作。
使用 map 调节亮度
之后可以将 map 与 PWM 配合使用来设置亮度。旋钮可以准确地映射到 LED 调光器所需的 0 到 255 范围。
int b = map(analogRead(A0), 0, 1023, 0, 255);您会反复使用的工具
您会经常用到 map：处理百分比、角度、范围等。它能将原始传感器数据转换为有意义的数值。
快速检查
map 函数的作用是什么？
回顾：使用 map 重新缩放
您了解到，map 使用五个参数在不同范围之间重新缩放数值。将它与 constrain 配合，可以把结果限制在安全边界内。
用 AI 导师学习 C++ — 免费
在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。
- 课程
- 30
- 课程
- 120
常见问题解答
「使用 map() 将数值映射到新范围」课时是免费的吗？
是的 — 「使用 map() 将数值映射到新范围」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Arduino & IoT Academy 课程的其余内容，请升级到 CoddyKit PRO。 Arduino & IoT Academy 课程共包含 4 节课。
「使用 map() 将数值映射到新范围」这节课中我会学到什么？
将原始读数重新缩放为实用单位 你通过在浏览器中直接运行的动手代码来练习 Arduino & IoT Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Arduino & IoT Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Arduino & IoT Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。
「使用 map() 将数值映射到新范围」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Arduino & IoT Academy 课中编写并运行代码吗？
能。每节 Arduino & IoT Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 数字信号与模拟信号
- analogRead 返回 0–1023
- 读取电位器旋钮
- 使用 map() 将数值映射到新范围