Vivado 命名约定 - 2023.2 简体中文

Vivado Design Suite 用户指南: 版本说明、安装和许可 (UG973)

Document ID
UG973
Release Date
2023-10-19
Version
2023.2 简体中文

以下是使用 Vivado Design Suite 时所需的命名约定。不满足这些命名约定可能对设计或工具引发潜在风险,并导致设计流程中出现不可预测的行为。

  • 源文件名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)以及下划线 (_)。
  • 输出文件名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)以及下划线 (_)。
  • 工程名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)以及下划线 (_)。
  • 工程目录名称必须以字母(A-Z 和 a-z)开头,并且只能包含字母数字字符(A-Z、a-z 和 0-9)、波浪线 (~) 以及下划线 (_)。
警告:
Windows 操作系统对于路径长度存在 260 个字符的限制,这可能影响 Vivado 工具。为避免此问题,创建工程、定义 IP 或托管 IP 工程或者创建块设计时,请尽可能使用较短的名称和目录位置。

针对工程名称、文件名或目录名称不支持使用下列字符:

  • ! # $ % ^ & * ( ) ` ; < > ? , [ ] { } ' " |
  • 制表符 (\t)
  • 回车符 (\r)
  • 换行符 (\n)
  • / 或 \(包含在目录名称或文件名中,而不是作为路径分隔符)

针对目录名称不支持使用下列字符:

  • 。(作为终结字符的点)

针对文件名称或工程名称不支持使用下列字符:

  • @
    注释:Vivado IDE 中,针对新文件名称或新工程名称不支持使用 @ 字符。Vivado IDE 支持将磁盘上名称包含 @ 字符的现有文件添加到工程中。Vivado IDE 可打开工程名称包含 @ 字符的工程。您可使用 Tcl Console(Tcl 控制台)创建名称包含 @ 字符的工程。
重要: Windows 操作系统支持目录名称和文件名中包含空格。但您应避免使用空格,以便保留 Windows 与 Linux 操作系统之间的工程或文件的可移植性。

Vivado Design Suite 支持使用正斜杠 (/) 作为 Windows 和 Linux 平台的路径分隔符。仅在 Windows 平台上允许使用反斜杠 (\) 作为路径分隔符。

不支持在工程名称、文件名或目录名称中使用以上未明确提及的任何字符。