Learning Processing 第 6.4 课:Processing 变量作用域(局部变量与全局变量)实战指南
Learning Processing 第 6.4 课:Processing 变量作用域(局部变量与全局变量)实战指南
导读
本指南围绕 Coding Train 项目 Learning Processing 课程 中 6.4 课《Variable Scope(变量作用域)》 展开,讲解 Processing/Java 中"全局变量"与"局部变量"的定义位置、可见范围与生命周期差异。读者学完后,将能判断变量应声明在 setup() / draw() 之外还是之内,避免常见的作用域错误,并理解为何课程中的动画、粒子与对象数组示例几乎都把状态变量放在顶层。文中所有代码示例均可直接在 Processing 环境中复制运行,并可在本仓库对应的 P5.js 与 Processing 源码 中找到同类实现作对照。
一、什么是变量作用域
作用域(Scope) 定义了变量在程序中可以被"看见"(访问)的范围。在 Processing(其底层语言为 Java)中,一个变量的作用域由它的声明位置决定:
- 声明在函数内部的变量称为局部变量(local variable),只能在该函数内部使用;
- 声明在所有函数之外(草图顶部)的变量称为全局变量(global variable),可以在草图的任何函数中被读取和修改。
课程原文给出了一句高度概括的定义:本视频覆盖了变量作用域的概念,在 Processing/Java 中演示"局部"变量与"全局"变量(This video covers the concept of a variable scope, demonstrating "local" and "global" variables in Processing / Java.)。下面用最小示例把这句话展开为可运行的代码。
二、全局变量:声明在顶层,处处可见
全局变量写在 setup() 与 draw() 之前,也就是草图文件的最外层。它们从程序启动到程序结束一直存在,可以被 setup()、draw() 以及你自定义的任何函数共享。仓库中大量真实草图都采用这一模式,例如 bouncingball.pde:
float circleX = 0; // 全局变量:圆的水平位置
float xspeed = 3; // 全局变量:水平速度
void setup() {
size(640, 360);
}
void draw() {
background(51);
fill(102);
stroke(255);
ellipse(circleX, height/2, 32, 32);
circleX = circleX + xspeed;
if (circleX > width || circleX < 0) {
// 掉头!速度反向并略微衰减
xspeed = xspeed * -0.9;
}
}
分析这段代码中的作用域分工:
| 变量 | 声明位置 | 作用域 | 生命周期 | 使用场景 |
|---|---|---|---|---|
circleX |
顶层(所有函数之外) | 全局:setup()、draw() 均可见 |
程序运行全程 | 记录球在动画循环中不断变化的位置 |
xspeed |
顶层 | 全局:draw() 内部可读写 |
程序运行全程 | 记录速度,并在边界碰撞时被修改 |
width / height |
Processing 内置常量 | 全局 | 程序运行全程 | 由 size() 决定画布尺寸 |
关键点:draw() 每秒被调用约 60 次,每次调用都会读取并修改 circleX 与 xspeed。如果这两个变量是 draw() 的局部变量,每次调用结束时就会被销毁、重新从 0 开始,弹跳动画也就无法累积状态。这正是动画程序必须把"有记忆"的状态变量声明为全局变量的根本原因。
三、局部变量:声明在函数内,用完即消失
局部变量声明在某个函数的花括号 { } 内部,作用域被限制在该函数(甚至更内层的代码块)之内:
void setup() {
int x = 100; // 局部变量:只能在 setup() 中使用
println(x); // 输出 100
}
void draw() {
// 错误:这里访问不到 setup() 里的 x
// println(x); // 编译错误:x cannot be resolved
}
局部变量有两条重要特征:
- 其他函数无法访问:上面的
draw()中引用x会直接导致编译错误,因为x不在draw()的作用域内; - 函数返回即销毁:每次函数调用开始时重新创建,调用结束时被回收,变量值不会在两次调用之间保留。
因此,如果你只需要一个"临时计算的中间值",用局部变量最合适;如果你需要跨函数共享或跨帧持续累积的状态,就必须用全局变量。
四、典型反例:循环变量声明位置的陷阱
局部变量最常见的体现是 for 循环的循环计数器。请对比下面两段代码:
错误写法(循环变量声明在循环内部):
void draw() {
for (int i = 0; i < 10; i++) { // i 是 for 循环的局部变量
println(i);
}
// println(i); // 编译错误:i 在循环结束后已超出作用域
}
可行写法(在函数顶部声明局部变量):
void draw() {
int i; // 局部变量:作用域覆盖整个 draw()
for (i = 0; i < 10; i++) {
println(i);
}
println(i); // 现在可以访问,输出 10
}
注意:int i 即使声明在函数内部,它仍然是局部变量,不会被其他函数访问到;它只是把作用域从 for 循环块扩大到了整个 draw()。作用域永远由声明位置的花括号层级决定,层级越深,可见范围越小。
五、函数参数也是局部变量
在 Processing 中,函数参数(形参)同样属于局部变量:它们只在该函数内部可见,并且在函数被调用时由实参赋值。仓库中的 Bubble.pde 是一个很好的实例:
class Bubble {
float x; // 类成员变量(对象级作用域)
float y;
float diameter;
Bubble(float tempD) { // tempD 是构造函数参数,属于局部变量
x = width/2;
y = height;
diameter = tempD; // 把局部参数的值赋给成员变量
}
void ascend() {
y--;
x = x + random(-2, 2);
}
void display() {
stroke(0);
fill(127, 100);
ellipse(x, y, diameter, diameter);
}
}
这里存在三层作用域:
- 全局层:主草图中的对象引用
b1、b2(见 sketch_8_3_BubbleObject.pde); - 对象层:
Bubble类的成员变量x、y、diameter,每个实例各有一份,任何成员方法都能访问; - 局部层:构造函数参数
tempD,只存在于构造函数内部,负责把外部传入的尺寸值"搬运"到成员变量中。
这种"参数作为局部变量、成员变量作为对象级全局变量"的结构,是所有面向对象草图的标准写法,也是理解后续 数组与对象 等进阶课程的基础。
六、常见错误与排查思路
作用域问题在 Processing 中通常表现为两类:
1. 编译错误:变量找不到(cannot be resolved to a variable)
- 症状:
println(x)报错x cannot be resolved to a variable; - 原因:在某个函数内引用了另一个函数的局部变量;
- 排查:把变量声明移到两个函数都能访问的顶层,或确认是否使用了完全一致的变量名。
2. 逻辑错误:动画不累积、值"被重置"
- 症状:程序能运行,但画面不随时间变化,或数值每次帧都回到初始值;
- 原因:把本应是全局的状态变量误声明为
draw()内部的局部变量,每帧重新初始化; - 排查:将需要跨帧保持的变量(位置、速度、计数等)移至顶层声明。
七、本课在课程体系中的位置
本课属于 Learning Processing 课程第 6 章 Loops(循环),与前后的知识点形成一条完整链路:
- 此前 4.1 变量 引入变量概念,4.2 变量自增 展示了
x = x + 1的累积写法; - 本课回答"这些不断累积的变量应该放在哪里";
- 后续 6.5 循环 vs draw() 进一步讨论"
draw()本身也是循环"时,哪些工作交给for循环、哪些交给draw()的逐帧循环,其判断前提正是对全局/局部变量生命周期的理解; - 再往后 7 章函数 与 8 章面向对象 中,变量作用域会从"全局 vs 局部"扩展到"类成员变量、参数、代码块变量"等更多层次。
八、小结与练习建议
- 判定口诀:跨函数共享、跨帧累积的状态 → 全局变量(顶层声明);函数内一次性的临时值 → 局部变量(函数内声明)。
- 最小练习:改写上面的弹跳球草图,故意把
circleX移进draw()内部声明,观察画面变化并体会"每帧重置"的效果;再把它移回顶层,恢复动画,从而直观掌握作用域对运行行为的影响。 - 进阶练习:仿照 Bubble 对象示例 自己定义一个类,用"全局引用 + 局部参数 + 对象成员变量"三层结构完成一次小动画,巩固本课的全部概念。