Quarto项目指定Localhost端口无效：配置后仍随机分配端口求助

解决Quarto预览端口固定/获取问题 #

一、正确配置固定端口 #

你之前的配置大概率因缩进格式错误导致不生效，Quarto的YAML配置对缩进层级要求严格，正确的_quarto.yml配置写法如下：

project:
  preview:
    port: 4200

注意：每个层级保持一致缩进（建议用2个空格），不要混用空格和制表符。

若配置后仍不生效，可直接在RStudio终端执行命令强制指定端口启动预览：

quarto preview --port 4200

二、获取当前使用的端口 #

如果需要在编织任务中动态获取端口，可通过以下两种方式实现：

1. 读取Quarto预览环境变量

在Quarto文档中嵌入R代码块，读取系统环境变量获取端口：

# 获取当前预览端口
preview_port <- Sys.getenv("QUARTO_PREVIEW_PORT")
# 若未设置环境变量， fallback 到默认值
if (preview_port == "") preview_port <- "4200"
cat("当前预览端口：", preview_port)

2. 直接读取Quarto配置文件

通过R代码加载_quarto.yml，提取配置的端口值：

library(yaml)
quarto_config <- yaml.load_file("_quarto.yml")
preview_port <- quarto_config$project$preview$port
cat("配置的固定端口：", preview_port)

补充提示 #

若RStudio的「Render」按钮仍不加载固定端口，可尝试重启RStudio，或删除项目目录下的_site缓存文件夹后重新渲染。

内容的提问来源于stack exchange，提问作者Kilsen