环境变量

    Julia 使用的环境变量通常以 JULIA 开头。如果调用 时关键字参数 verbose = true，那么输出的结果将列出与 Julia 相关的已定义环境变量，即包括那些名称中包含 JULIA 的环境变量。

    Note

    某些变量需要在 Julia 启动之前设置，比如 JULIA_NUM_THREADS 和 JULIA_PROJECT，因为在启动过程中将这些变量添加到 ~/.julia/config/startup.jl 中为时已晚。在 Bash 中，环境变量可以手动设置，这可通过在 Julia 启动前运行诸如 export JULIA_NUM_THREADS=4 的命令，亦可通过向 -/.bashrc 或 ~/.bash_profile 添加相同命令来在 Bash 每次启动时设置该变量。

    包含 Julia 可执行文件的目录的绝对路径，它会设置全局变量 Sys.BINDIR。$JULIA_BINDIR 如果没有设置，那么 Julia 会在运行时确定 Sys.BINDIR 的值。

    在默认情况下，可执行文件是指：

    全局变量 Base.DATAROOTDIR 是一个从 Sys.BINDIR 到 Julia 数据目录的相对路径。

    1. $JULIA_BINDIR/$DATAROOTDIR/julia/base

    上述路径是 Julia 最初搜索源文件的路径（通过 Base.find_source_file()）。

    同样，全局变量 Base.SYSCONFDIR 是一个到配置文件目录的相对路径。在默认情况下，Julia 会在下列文件中搜索 startup.jl 文件（通过 Base.load_julia_startup()）

    例如，一个 Linux 安装包的 Julia 可执行文件位于 /bin/julia，DATAROOTDIR 为 ../share，SYSCONFDIR 为 ../etc，JULIA_BINDIR 会被设置为 /bin，会有一个源文件搜索路径：

    1. /share/julia/base

    和一个全局配置文件搜索路径：

    JULIA_PROJECT

    指向当前 Julia 项目的目录路径。设置此环境变量与指定 —project 启动选项效果相同，但 —project 的优先级更高。如果此变量被设置为 @.，那么 Julia 会尝试在当前目录及其父目录中寻找包含 Project.toml 或 JuliaProject.toml 文件的目录。另请参阅 一章。

    Note

    JULIA_PROJECT 必须在启动 julia 前定义；在启动过程中于 startup.jl 中定义它为时已晚。

    JULIA_LOAD_PATH

    一个会被附加到变量 LOAD_PATH 的绝对路径组成的分隔列表（在类 Unix 系统中，: 为路径分隔符；在 Windows 系统中，; 为路径分隔符）。LOAD_PATH 变量是 和 Base.load_in_path() 寻找代码的地方。它默认为绝对路径 $JULIA_HOME/../share/julia/stdlib/v$(VERSION.major).$(VERSION.minor)，例如，假设操作系统为 Linux、Julia 版本为 0.7、Julia 可执行文件的路径为 ，那么 LOAD_PATH 默认为 /share/julia/stdlib/v0.7。

    JULIA_HISTORY

    REPL 历史文件中 REPL.find_hist_file() 的绝对路径。如果没有设置 $JULIA_HISTORY，那么 REPL.find_hist_file() 默认为

    1. $HOME/.julia/logs/repl_history.jl

    JULIA_PKGRESOLVE_ACCURACY

    一个正的 Int 值，用于约束 MaxSum.maxsum() 的执行时间。此变量默认为 1，更大的值对应更大的时间量。MaxSum.maxsum() 是 max-sum 的子例程，它的作用是解析包的依赖性，在允许的时间内，它会尽可能满足约束，直到放弃。

    • 预抽取的迭代次数为 20*n，
    • 抽取步骤间的迭代次数是 10*n，并且
    • 在抽取步骤中，每 20*n 包中至多有一个被抽取

    JULIA_SHELL

    Julia 用来执行外部命令的 shell 的绝对路径（通过 Base.repl_cmd()）。默认为环境变量 $SHELL，如果 $SHELL 未设置，则为 /bin/sh。

    Note

    在 Windows 上，此环境变量将被忽略，并且外部命令会直接被执行。

    JULIA_EDITOR

    InteractiveUtils.editor() 的返回值–编辑器，例如，InteractiveUtils.edit，会启动偏好编辑器，比如 vim。

    $JULIA_EDITOR 优先于 $VISUAL，而后者优先于 $EDITOR。如果这些环境变量都没有设置，那么在 Windows 和 OS X 上会设置为 open，或者 /etc/alternatives/editor（如果存在的话），否则为 emacs。

    JULIA_CPU_THREADS

    改写全局变量 ，逻辑 CPU 核心数。

    一个 Float64 值，用来确定 Distributed.worker_timeout() 的值（默认：60.0）。此函数提供 worker 进程在死亡之前等待 master 进程建立连接的秒数。

    JULIA_NUM_THREADS

    一个无符号 64 位整数（uint64_t），用来设置 Julia 可用线程的最大数。如果 $JULIA_NUM_THREADS 超过可用的物理 CPU 核心数，那么线程数设置为核心数。如果 $JULIA_NUM_THREADS 不是正数或没有设置，或者无法通过系统调用确定 CPU 核心数，那么线程数就会被设置为 1。

    Note

    JULIA_NUM_THREADS 必须在启动 julia 前定义；在启动过程中于 startup.jl 中定义它为时已晚。

    JULIA_THREAD_SLEEP_THRESHOLD

    如果被设置为字符串，并且以大小写敏感的子字符串 "infinite" 开头，那么z自旋线程从不睡眠。否则，$JULIA_THREAD_SLEEP_THRESHOLD 被解释为一个无符号 64 位整数（uint64_t），并且提供以纳秒为单位的自旋线程睡眠的时间量。

    JULIA_EXCLUSIVE

    如果设置为 0 以外的任何值，那么 Julia 的线程策略与在专用计算机上一致：主线程在 proc 0 上且线程间是关联的。否则，Julia 让操作系统处理线程策略。

    决定 REPL 应当如何格式化输出的环境变量。通常，这些变量应当被设置为 。Julia 提供了具有相同功能的高级接口；请参阅 Julia REPL 章节。

    JULIA_ERROR_COLOR

    Base.error_color()（默认值：亮红，"\033[91m"），errors 在终端中的格式。

    JULIA_WARN_COLOR

    Base.warn_color()（默认值：黄，），warnings 在终端中的格式。

    JULIA_INFO_COLOR

    Base.info_color()（默认值：青，"\033[36m"），info 在终端中的格式。

    JULIA_INPUT_COLOR

    Base.answer_color()（默认值：标准，"\033[0m"），在终端中，输出应有的格式。

    JULIA_STACKFRAME_LINEINFO_COLOR

    Base.stackframe_lineinfo_color()（默认值：粗体，"\033[1m"），栈跟踪时行信息在终端中的格式。

    JULIA_STACKFRAME_FUNCTION_COLOR

    Base.stackframe_function_color()（默认值：粗体，"\033[1m"），栈跟踪期间函数调用在终端中的形式。

    JULIA_GC_ALLOC_POOL, JULIA_GC_ALLOC_OTHER, JULIA_GC_ALLOC_PRINT

    这些环境变量取值为字符串，可以以字符 ‘r’ 开头，后接一个由三个带符号 64 位整数（int64_t）组成的、以冒号分割的列表的插值字符串。这个整数的三元组 a:b:c 代表算术序列 a, a + b, a + 2*b, … c。

    • 如果是第 n 次调用 jl_gc_pool_alloc()，并且 n 属于 $JULIA_GC_ALLOC_POOL 代表的算术序列， 那么垃圾回收是强制的。
    • 如果是第 n 次调用 maybe_collect()，并且 n 属于 $JULIA_GC_ALLOC_OTHER 代表的算术序列，那么垃圾 回收是强制的。
    • 如果是第 n 次调用 jl_gc_alloc()，并且 n 属于 $JULIA_GC_ALLOC_PRINT 代表的算术序列，那么 调用 jl_gc_pool_alloc() 和 maybe_collect() 的次数会 被打印。如果这些环境变量的值以字符 ‘r' 开头，那么垃圾回收事件间的间隔是随机的。

    Note

    这些环境变量生效要求 Julia 在编译时带有垃圾收集调试支持（也就是，在构建配置中将 WITH_GC_DEBUG_ENV 设置为 1）。

    JULIA_GC_NO_GENERATIONAL

    如果设置为 0 以外的任何值，那么 Julia 的垃圾收集器将从不执行「快速扫描」内存。

    Note

    此环境变量生效要求 Julia 在编译时带有垃圾收集调试支持（也就是，在构建配置中将 WITH_GC_DEBUG_ENV 设置为 1）。

    JULIA_GC_WAIT_FOR_DEBUGGER

    如果设置为 0 以外的任何值，Julia 的垃圾收集器每当出现严重错误时将等待调试器连接而不是中止。

    Note

    此环境变量生效要求 Julia 在编译时带有垃圾收集调试支持（也就是，在构建配置中将 WITH_GC_DEBUG_ENV 设置为 1）。

    ENABLE_JITPROFILING

    如果设置为 0 以外的任何值，那么编译器将为即时（JIT）性能分析创建并注册一个事件监听器。

    Note

    此变量生效要求 Julia 编译时带有 JIT 性能分析支持，请使用

    • 英特尔的 （在构建配置中将 USE_INTEL_JITEVENTS 设置为 1），或
    • OProfile（在构建配置中将 USE_OPROFILE_JITEVENTS 设置为 1）。

    JULIA_LLVM_ARGS

    传递给 LLVM 后端的参数。