如何将config.toml接入Streamlit应用？配置未生效求助

1. 自动关联逻辑 #

Streamlit启动时会自动按优先级查找配置文件，无需手动连接：

• 命令行通过--config-file参数指定的路径
• 当前工作目录下的.streamlit/config.toml
• 用户主目录下的.streamlit/config.toml

你的项目结构中，.streamlit放在Source_Code根目录下，只要从Source_Code目录启动Streamlit（比如执行streamlit run runner.py），程序就会自动加载该配置文件。

2. 衬线字体的正确配置写法 #

配置不生效大概率是内容有误，要全局设置衬线字体，config.toml需按以下格式编写：

[theme]
primaryColor="#FF4B4B"
backgroundColor="#FFFFFF"
secondaryBackgroundColor="#F0F2F6"
textColor="#111111"
font="serif"  # 指定衬线字体，可选值还有 "sans serif"、"monospace"

注意：font字段只能用Streamlit官方支持的三个选项，自定义字体名称不会生效。

3. 其他排查方向 #

• 启动路径错误：如果从Source_Code的上级目录启动（比如streamlit run Source_Code/runner.py），程序会在上级目录查找.streamlit，而非项目根目录，需先进入Source_Code目录再启动。
• 缓存残留：重启Streamlit服务，清除旧配置缓存。
• 语法错误：检查config.toml的拼写和格式，比如是否漏写括号、引号，或字段名拼写错误（如把theme写成themes）。

内容的提问来源于stack exchange，提问作者Mohammed H.