Install Streamlit using command line
本页面将引导您使用venv创建环境并使用pip安装Streamlit。这些是我们推荐的工具，但如果您熟悉其他工具，也可以使用您喜欢的工具。最后，您将构建一个简单的“Hello world”应用程序并运行它。如果您更喜欢使用图形界面来管理您的Python环境，请查看如何使用Anaconda Distribution安装Streamlit。
Prerequisites
与任何编程工具一样，为了安装Streamlit，首先需要确保您的计算机已正确设置。更具体地说，您需要：
-
Python
我们支持 version 3.9 to 3.13.
-
Python 环境管理器（推荐）
环境管理器创建虚拟环境，以隔离项目之间的 Python 包安装。
我们推荐使用虚拟环境，因为安装或升级 Python 包可能会对另一个包产生意外影响。有关 Python 环境的详细介绍，请查看 Python 虚拟环境：入门指南。
在本指南中，我们将使用 Python 自带的
venv。 -
Python 包管理器
包管理器负责安装每个 Python 包，包括 Streamlit。
在本指南中，我们将使用 Python 自带的
pip。 -
仅在MacOS上：Xcode命令行工具
使用这些说明下载Xcode命令行工具，以便让包管理器安装一些Streamlit的依赖项。
-
代码编辑器
我们最喜欢的编辑器是 VS Code，这也是我们在所有教程中使用的编辑器。
Create an environment using venv
-
打开终端并导航到您的项目文件夹。
cd myproject -
在您的终端中，输入：
python -m venv .venv -
一个名为".venv"的文件夹将出现在你的项目中。这个目录是你的虚拟环境及其依赖项的安装位置。
Activate your environment
-
在您的终端中，根据您的操作系统，使用以下命令之一激活您的环境。
# Windows 命令提示符 .venv\Scripts\activate.bat # Windows PowerShell .venv\Scripts\Activate.ps1 # macOS 和 Linux source .venv/bin/activate -
一旦激活，您将在提示符前看到您的环境名称在括号中。"(.venv)"
Install Streamlit in your environment
-
在激活环境的终端中，输入：
pip install streamlit -
通过启动 Streamlit Hello 示例应用程序来测试安装是否成功：
streamlit hello如果这不起作用，请使用长格式命令：
python -m streamlit hello -
Streamlit的Hello应用程序应该会在你的网页浏览器的新标签页中显示！
-
完成后关闭您的终端。
Create a "Hello World" app and run it
- 在您的项目文件夹中创建一个名为
app.py的文件。
import streamlit as st
st.write("Hello world")
- 任何时候你想使用你的新环境，首先需要进入你的项目文件夹（
.venv目录所在的位置）并运行命令来激活它：
# Windows command prompt
.venv\Scripts\activate.bat
# Windows PowerShell
.venv\Scripts\Activate.ps1
# macOS and Linux
source .venv/bin/activate
-
一旦激活，您将在终端提示符的开头看到您的环境名称在括号中。"(.venv)"
-
运行你的 Streamlit 应用。
streamlit run app.py
如果这不起作用，请使用长格式命令：
python -m streamlit run app.py
-
要停止 Streamlit 服务器，请在终端中按
Ctrl+C。 -
当你使用完这个环境后，通过输入以下命令返回到你的正常 shell：
deactivate
What's next?
阅读我们的基本概念以了解Streamlit的数据流模型。
还有问题吗？
我们的 论坛 充满了有用的信息和Streamlit专家。