创建变量以便用于 Part Studio 中的表达式并赋值。在尺寸和表达式中使用变量。变量是 Onshape 中的特征，因此如何在特征列表中放置非常重要。在要在其中使用变量的特征前创建变量，或操作过程中需要变量时进行实时创建。

  1. 在 Part Studio 中，单击 变量特征图标 打开“变量”对话框。

    变量对话框

  1. 在对话框中：

    1. 输入变量的名称（参考变量所依据的名称）。

      2. 在名称中只能使用英文字母和数字（至少一个英文字母后跟多个字母和/或数字）。变量名称区分大小写。

    2. 选择类型：
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 角度 - 代表角度的数值（小数、整数、分数）
      • 数字 - 数值（小数、整数、分数）
      • 任意项目 - 上述任意项目，具有不同单位的数值，或 FeatureScript 值，例如布尔、映射、数组、字符串或函数。请参见 https://cad.onshape.com/FsDoc/variables.htm#standard-types 及下面的示例。
    3. 输入一个值（可选：长度、角度及任意项目的单位）。
    4. 输入变量的自定义说明。
  2. 单击 接受复选标记图标。
  1. 在 Part Studio 中，单击 变量特征图标 打开“变量”对话框，然后单击“测量”：

    测量变量对话框

  2. 在对话框中：
    1. 选择类型：
      • 距离 - 表示距离的数值（小数、整数、分数）
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 直径 - 表示直径的数值（小数、整数、分数）

    2. 输入变量的名称（参考变量所依据的名称）。

      3. 在名称中只能使用英文字母和数字（至少一个英文字母后跟多个字母和/或数字）。变量名称区分大小写。

    3. 选择要测量其间距的图元。
    4. 根据您的喜好填写剩余输入框。
  3. 单击 接受复选标记图标。

创建尺寸，在尺寸输入框中输入 # 和变量名称（也可作为表达式的一部分，如下所示）：

变量示例：向圆形尺寸添加变量 和变量示例：向矩形的长度尺寸添加变量

保存尺寸，变量会替换为值，并且会求解表达式（如果适用）：

显示从圆和矩形的变量派生的尺寸的变量示例

双击尺寸进行编辑时，会显示变量（和表达式）：

正在显示的变量的示例

如果使用不带变量的表达式作为草图尺寸，则在尺寸值左侧使用不带变量的表达式图标 (没有可变指示器的表达式图标) 进行指示。如果将带有变量的表达式用于草图尺寸，则在尺寸值左侧使用带变量的表达式图标 (具有可变指示器的表达式图标) 进行指示。请参见在草图中显示表达式。

在 Part Studio 中使用表达式的任何地方均可使用变量。例如，在拉伸或旋转运算中。

像往常一样开始操作（在本例中是旋转），在数值输入框中输入 # 和变量名称（也可作为表达式的一部分）：

在实体零件特征中使用变量的示例

接受特征。

编辑特征时，会在数值输入框中显示求解：

在实体零件特征中使用变量并显示数值输入框中所显示的分辨率的示例

在输入框中单击，会显示变量（在适当的情况下，还会显示表达式）。

变量自动填充特征

定义变量后，如果在数值对话框输入框中输入井号标签（或者井号、下划线或任何字母），将打开变量自动填充特征，如下所示：

变量自动填充特征示例 变量自动填充特征示例

左侧的对话框是“拉伸”对话框，其中“深度”输入框处于活动状态；右侧的框是草图中的尺寸输入框。

您可以一直键入内容以筛选列表中的合理选项，使用方向键可在列表中上移和下移，当列表中的变量亮显时，使用 Enter 键可接受该变量。您也可以使用鼠标滚轮来滚动变量列表，并通过单击鼠标来选择特定的变量。请注意，如果未使用井号 (#)，FeatrureScript 函数也会包含在列表中：

显示可用变量列表的变量自动填充特征示例

另请注意以下几点：

  • 使用 Esc 键可关闭下拉列表而不选择任何内容。如果从下拉列表中移除焦点，也会将其关闭而不选择任何内容。
  • 计算值显示为浅灰色，不会插入这些值（仅插入变量或函数名称）。函数输入也是如此，因为不插入输入占位符名称。
  • 仅显示当前使用环境中存在的变量，而不显示特征列表中再往下的变量

变量值可以包含表达式。您可以指定带索引的数组，该索引可以是变量。这样，您可以通过更改索引变量的值来更改变量的值。

要在变量中使用数组，必须先设置基于零的索引。

  1. 创建一个变量并将名称设置为“config”。选择“数字”作为类型，将 #config 的值设置为“2”。
  2. 创建一个变量，将名称设置为“diameter”。将 #diameter 的值设置为“[0.25, 0.5, 1][#config]”。

    3. 第二组方括号 [#config] 充当数组中的索引指针。

  3. 创建一个变量，将名称设置为“length”。将 #length 的值设置为“[2, 4, 10][#config]”。

  4. 创建一个圆。
  5. 创建一条线。
  6. 将圆的直径设置为“#diameter”。

    因为 #config = 2，所以圆的直径为 1。

  7. 将线的长度设置为“#length”。

    因为 #config = 2，所以线的长度为 10。

更改索引变量的值即可更改所有数组变量的索引。

您可以根据需要创建变量，例如在特征对话框的输入框中输入数字值时。该变量会保存在特征列表中的当前操作之前。

例如，在创建草图的过程中弹出尺寸对话框时，除了输入尺寸的值，您也可以输入 #，系统会显示现有变量的列表，同时显示“新建变量”选项：

在搜索输入框中输入井号以显示可接受变量的可选择列表的示例

选择“新建变量”打开“变量”对话框以创建新变量，然后将其用于当前输入框。（或者如果适用，请从当前变量中选择一个）

选择变量以打开“变量”对话框

通过“创建变量”对话框，您可以为特征（默认）或配置创建变量。

创建变量对话框

为新变量输入名称和值。单击复选标记以保存新变量并将其用于打开的特征。

根据 FeatureScript 语句，您可以在变量中使用 FeatureScript 函数 。

例如，您可以创建名为“调整”的“任意项目”类型的变量，以保存将指定长度加倍并加上 2.5 mm 的函数，如下所示：

function(len) { return len * 2 + 2.5 mm; }

然后在表达式中参考该变量，例如：

#Adjust(20mm)

变量中的 FeatureScript 函数的示例

  • 更改变量的值时（像编辑任何特征一样来编辑变量），使用该变量的所有运算都会自动更新。
  • 更改变量的名称后，可以选中将更改应用于使用该变量的所有位置：

    更改变量名称的示例

    选中 “更新所有参考” 旁边的方框。

  1. 在 Part Studio 中，选择“变量”工具 变量特征图标 以打开“变量工具”对话框：

    变量工具对话框

  2. 在对话框中：
    1. 选择类型：
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 角度 - 代表角度的数值（小数、整数、分数）
      • 数字 - 数值（小数、整数、分数）
      • 任意项目 - 上述任意项目，具有不同单位的数值，或 FeatureScript 值，例如布尔、映射、数组、字符串或函数。请参见 https://cad.onshape.com/FsDoc/variables.htm#standard-types 及下面的示例。
    2. 输入变量的名称（参考变量所依据的名称）。

      3. 在名称中只能使用英文字母和数字（至少一个英文字母后跟多个字母和/或数字）。变量名称区分大小写。

    3. 输入一个值（可选：长度、角度及任意项目的单位）。
  3. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

  1. 在 Part Studio 中，选择“变量”工具 变量特征图标 以打开“变量工具”对话框，然后单击“测量”：

    测量变量工具对话框

  2. 在对话框中：
    1. 选择类型：
      • 距离 - 表示距离的数值（小数、整数、分数）
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 直径 - 表示直径的数值（小数、整数、分数）

  3. 输入变量的名称（参考变量所依据的名称）。

      在名称中只能使用英文字母和数字（至少一个英文字母后跟多个字母和/或数字）。变量名称区分大小写。

    1. 选择要测量其间距的图元。
    2. 根据您的喜好填写剩余输入框。
  4. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

创建尺寸，在尺寸输入框中输入 # 和变量名称（也可作为表达式的一部分，如下所示）：

变量示例：向圆形尺寸添加变量 和变量示例：向矩形的长度尺寸添加变量

保存尺寸，变量会替换为值，并且会求解表达式（如果适用）：

显示从圆和矩形的变量派生而来的尺寸的变量示例

双击尺寸进行编辑时，会显示变量（和表达式）：

正在显示的变量的示例

在 Part Studio 中使用表达式的任何地方均可使用变量。例如，在拉伸或旋转运算中：

像往常一样开始操作（在本例中是旋转），在数值输入框中输入 # 和变量名称（也可作为表达式的一部分）。例如：(#x) deg。

接受特征。

编辑特征时，会在数值输入框中显示求解。例如：4 deg。

在输入框中单击，会显示变量（在适当的情况下，还会显示表达式）。

变量值可以包含表达式，但是必须求得标量值。您可以指定带索引的数组，该索引可以是变量。这样，您可以通过更改索引变量的值来更改变量的值。

要在变量中使用数组，必须先设置基于零的索引。

  1. 轻按变量工具，将名称设置为“config”。将 #config 的值设置为 2。
  2. 轻按变量工具，将名称设置为“diameter”。将 #diameter 的值设置为 [0.25, 0.5, 1] [#config]。

    3. 请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

  3. 轻按变量工具，将名称设置为“length”。将 #length 的值设置为 [2, 4, 10] [#config]。

    4. 请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

  4. 轻按草图工具，绘制一个圆的草图。
  5. 轻按草图工具，绘制一条线的草图。
  6. 将圆的直径设置为“#diameter”。
  7. 将线的长度设置为“#length”。

    圆的直径设置为 1，线的长度设置为 10。

  8. 编辑 #config 变量，将值设置为 0。

草图将会更新，圆的直径现在设置为 0.25，线的长度设置为 2。

您可以按照自己的意愿针对任意多个数组执行此操作，数组可以容纳无限个位置（并不是如本例中所示那样仅限于三个值）。

根据 FeatureScript 语句，您可以在变量中使用 FeatureScript 函数 。

例如，您可以创建名为“调整”的“任意项目”类型的变量，以保存将指定长度加倍并加上 2.5 mm 的函数，如下所示：

function(len) { return len * 2 + 2.5 mm; }

然后在表达式中参考该变量，例如：

#Adjust(20mm)

变量中的 FeatureScript 函数的示例

  • 更改变量的值时（像编辑任何特征一样来编辑变量），使用该变量的所有运算都会自动更新。
  • 变量名称区分大小写。
  • 您可以输入变量作为独立的值或作为方程的一部分。
  • 您可以在尺寸标注、表达式或特征中使用变量。

  • 如果您指定没有单位的变量，表达式也将没有单位或假定工作区单位。但是，如果您明确为变量值添加单位，则任何表达式在编写时也应匹配该单位才能有效。

  • 更改变量的名称后，可以选中将更改应用于使用该变量的所有位置：

    变量对话框

    选择“更新所有参考”。

  1. 在 Part Studio 中，选择“变量”工具 变量特征图标 以打开“变量工具”对话框：

    变量工具对话框

  2. 在对话框中：
    1. 选择类型：
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 角度 - 代表角度的数值（小数、整数、分数）
      • 数字 - 数值（小数、整数、分数）
      • 任意项目 - 上述任意项目，具有不同单位的数值，或 FeatureScript 值，例如布尔、映射、数组、字符串或函数。请参见 https://cad.onshape.com/FsDoc/variables.htm#standard-types 及下面的示例。
    2. 输入变量的名称（参考变量所依据的名称）。

      3. 在名称中只能使用英文字母和数字（至少一个英文字母后跟多个字母和/或数字）。变量名称区分大小写。

    3. 输入一个值（可选：长度、角度及任意项目的单位）。
  3. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

  1. 在 Part Studio 中，选择“变量”工具 变量特征图标 以打开“变量工具”对话框，然后单击“测量”：

    测量变量工具对话框

  2. 在对话框中：
    1. 选择类型：
      • 距离 - 表示距离的数值（小数、整数、分数）
      • 长度 - 代表长度的数值（小数、整数、分数）
      • 直径 - 表示直径的数值（小数、整数、分数）

  3. 输入变量的名称（参考变量所依据的名称）。

      在名称中只能使用英文字母和数字（至少一个英文字母后跟多个字母和/或数字）。变量名称区分大小写。

    1. 选择要测量其间距的图元。
    2. 根据您的喜好填写剩余输入框。
  4. 轻按复选标记。

您创建的变量列在特征列表中，显示变量的名称和值。

创建尺寸，在尺寸输入框中输入 # 和变量名称（也可作为表达式的一部分，如下所示）：

变量示例：向圆形尺寸添加变量 和变量示例：向矩形的长度尺寸添加变量

保存尺寸，变量会替换为值，并且会求解表达式（如果适用）：

显示从圆和矩形的变量派生的尺寸的变量示例

双击尺寸进行编辑时，会显示变量（和表达式）：

正在显示的变量的示例

在 Part Studio 中使用表达式的任何地方均可使用变量。例如，在拉伸或旋转运算中：

像往常一样开始操作（在本例中是旋转），在数值输入框中输入 # 和变量名称（也可作为表达式的一部分）。例如：(#x) deg。

接受特征。

编辑特征时，会在数值输入框中显示求解。例如：4 deg。

在输入框中单击，会显示变量（在适当的情况下，还会显示表达式）。

变量值可以包含表达式，但是必须求得标量值。您可以指定带索引的数组，该索引可以是变量。这样，您可以通过更改索引变量的值来更改变量的值。

要在变量中使用数组，必须先设置基于零的索引。

  1. 轻按变量工具，将名称设置为“config”。将 #config 的值设置为 2。
  2. 轻按变量工具，将名称设置为“diameter”。将 #diameter 的值设置为 [0.25, 0.5, 1] [#config]。

    3. 请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

  3. 轻按变量工具，将名称设置为“length”。将 #length 的值设置为 [2, 4, 10] [#config]。

    4. 请务必包含括住“#config”的第二组括号，这样可以使变量 #config 的值可以指向数组中的正确位置。

  4. 轻按草图工具，绘制一个圆的草图。
  5. 轻按草图工具，绘制一条线的草图。
  6. 将圆的直径设置为“#diameter”。
  7. 将线的长度设置为“#length”。

    圆的直径设置为 1，线的长度设置为 10。

  8. 编辑 #config 变量，将值设置为 0。

草图将会更新，圆的直径现在设置为 0.25，线的长度设置为 2。

您可以针对任意多个数组执行此操作，您的数组可以容纳无限位（并不是如本例中所示那样仅限于三个值）。

根据 FeatureScript 语句，您可以在变量中使用 FeatureScript 函数 。

例如，您可以创建名为“调整”的“任意项目”类型的变量，以保存将指定长度加倍并加上 2.5 mm 的函数，如下所示：

function(len) { return len * 2 + 2.5 mm; }

然后在表达式中参考该变量，例如：

#Adjust(20mm)

变量中的 FeatureScript 函数的示例

  • 更改变量的值时（像编辑任何特征一样来编辑变量），使用该变量的所有运算都会自动更新。
  • 变量名称区分大小写。
  • 您可以输入变量作为独立的值或作为方程的一部分。
  • 您可以在尺寸标注、表达式或特征中使用变量。

如需其他学习中心资源，请点击此处的技术简报文章：参数化变量与配置变量（需要 Onshape 帐户）。您还可以注册以下课程：变量和表达式（需要 Onshape 帐户）。