Learning Processing 第 6.4 课:Processing 变量作用域(局部变量与全局变量)实战指南

原创2026-10-12 18:12:361,849 阅读
文章标签:教程文档示例工程

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
}

局部变量有两条重要特征:

  1. 其他函数无法访问:上面的 draw() 中引用 x 会直接导致编译错误,因为 x 不在 draw() 的作用域内;
  2. 函数返回即销毁:每次函数调用开始时重新创建,调用结束时被回收,变量值不会在两次调用之间保留。

因此,如果你只需要一个"临时计算的中间值",用局部变量最合适;如果你需要跨函数共享或跨帧持续累积的状态,就必须用全局变量。

四、典型反例:循环变量声明位置的陷阱

局部变量最常见的体现是 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);
  }
}

这里存在三层作用域:

  1. 全局层:主草图中的对象引用 b1、b2(见 sketch_8_3_BubbleObject.pde);
  2. 对象层:Bubble 类的成员变量 x、y、diameter,每个实例各有一份,任何成员方法都能访问;
  3. 局部层:构造函数参数 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 对象示例 自己定义一个类,用"全局引用 + 局部参数 + 对象成员变量"三层结构完成一次小动画,巩固本课的全部概念。
登录后查看全文
website-archive