- 让 Sublime Text 的代码提示（自动补全）能够识别你安装的第三方库。
- 让 Sublime Text 的构建系统（Build System）能够找到并运行你指定的 Python 解释器。
这两个问题有时是关联的，但设置方法不同,下面我将分步详细说明。
修复代码提示（自动补全）
当你安装了像 requests, numpy 这样的第三方库，但在 Sublime 中按 Ctrl + Space 却没有提示时，就是因为 Sublime Text 不知道你的 Python 解释器在哪里,也就找不到这些库的安装路径。
解决方法：配置 SublimeLinter 和 LSP 插件
这是目前最主流和推荐的方法，通过强大的 Language Server Protocol (LSP) 插件来提供准确的代码提示。
安装必要的插件
确保你已经通过 Package Control 安装了以下插件：
- LSP: 核心插件,提供语言服务器协议支持。
- LSP-pyright: Python 的语言服务器，提供高质量的代码分析和自动补全，它比传统的 Jedi 插件更强大。
- Anaconda: 一个老牌但功能强大的 Python 插件，也可以提供代码提示，如果你更喜欢它，也可以只安装这一个，但 LSP 是更现代的选择。
配置 LSP-pyright 以找到正确的 Python 路径
LSP-pypress 会自动尝试找到你的 Python 解释器,但有时需要手动指定。
-
方法 A：通过 Sublime Text 的命令面板（推荐）
- 打开你的 Python 项目文件（
.py文件）。 - 按
Ctrl + Shift + P(Windows/Linux) 或Cmd + Shift + P(Mac) 打开命令面板。 - 输入并选择
LSP: Select LSP for Current View。 - 在弹出的列表中选择
pyright。 - 再次打开命令面板，输入并选择
LSP: Select Language Server Configuration。 - 选择
pyright。 - 现在会打开一个配置文件
pyright.config.json，在这个文件中，你可以指定 Python 路径。
配置文件示例 (
pyright.config.json):
（图片来源网络，侵删）{ "python.pythonPath": "C:\\Python39\\python.exe" // Windows 示例 // "python.pythonPath": "/usr/bin/python3" // Linux / macOS 示例 // "python.pythonPath": "/Users/yourname/opt/anaconda3/bin/python" // Anaconda 示例 }将路径替换为你自己的 Python 解释器路径，保存文件后，重启 Sublime Text 或重新加载窗口（
Ctrl + Shift + P->LSP: Restart Server）即可生效。 - 打开你的 Python 项目文件（
-
方法 B：直接修改用户配置文件
- 打开命令面板 (
Ctrl + Shift + P)。 - 输入并选择
Preferences: Settings。 - 在打开的窗口中，选择右上角的 图标，选择 "Syntax-Specific - Python" (或者直接在用户设置中添加)。
- 在设置文件中添加以下配置：
{ "lsp": { "pyright": { "python": "C:\\Python39\\python.exe" // 你的 Python 路径 } } }同样,替换路径并保存。
- 打开命令面板 (
修复构建系统（运行 Python 脚本）
当你按 Ctrl + B 运行 Python 脚本时，Sublime Text 会使用一个默认的 Python 解释器，如果你电脑上装了多个 Python 版本（Python 2.7 和 Python 3.9），或者你希望使用 Anaconda 环境,就需要修改构建系统。
解决方法：创建自定义构建系统
打开构建系统菜单
- 点击菜单栏
Tools->Build System->New Build System...。
编写自定义构建系统配置
这会打开一个新文件，里面是默认的 Python 构建系统配置，将其内容替换为以下内容,并根据你的系统进行修改。
Windows 示例 (使用 Python 3.9):
{
"cmd": ["C:\\Python39\\python.exe", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python",
"encoding": "cp936", // 根据你的系统编码调整，防止中文乱码
"env": {"PYTHONIOENCODING": "utf8"} // 设置环境变量，确保控制台输出中文
}
Linux / macOS 示例 (使用系统 Python 3):
{
"cmd": ["/usr/bin/python3", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python",
"encoding": "utf-8"
}
Anaconda 环境示例 (非常常见):
假设你的 Anaconda 安装在 C:\Users\YourName\anaconda3，并且你创建了一个名为 myenv 的虚拟环境。
{
"cmd": ["C:\\Users\\YourName\\anaconda3\\envs\\myenv\\python.exe", "-u", "$file"],
"file_regex": "^[ ]*File \"(...*?)\", line ([0-9]*)",
"selector": "source.python",
"encoding": "cp936",
"env": {"PYTHONIOENCODING": "utf8"}
}
配置参数说明:
"cmd": 这是最重要的部分，它是一个数组，定义了要执行的命令。"C:\\Python39\\python.exe": 这是你要指定的 Python 解释器的完整路径，请务必使用反双斜杠\\或正斜杠 。"-u": 表示 Python 以“无缓冲”模式运行，这样你可以实时看到print输出。"$file": Sublime Text 的变量,代表当前打开的文件名。
"file_regex": 用于解析编译/运行错误信息,点击错误信息可以直接跳转到代码行。"selector": 告诉 Sublime 这个构建系统应用于哪种语法的文件，source.python表示所有 Python 文件。
保存并使用
- 保存这个文件，Sublime Text 会提示你输入文件名，
Python3-Custom.sublime-build。请务必以.sublime-build。 - 保存后，再次点击
Tools->Build System，你会在列表底部看到你刚刚创建的Python3-Custom。 - 选择它,它就会被设为当前构建系统。
- 以后，只要你在 Python 文件中按
Ctrl + B，就会使用你指定的 Python 解释器来运行代码了。
如何找到我的 Python 路径？
如果你不确定 Python 的安装路径,可以通过以下方法找到：
在命令行/终端中查找
打开你的命令提示符 (Windows) 或终端 (macOS/Linux),输入：
# 查找默认的 Python 路径 where python # Windows which python3 # macOS / Linux # 如果你有多个版本，可以指定查找 where python3 # Windows which python # macOS / Linux (通常指向 Python 2)
在 Python 交互式环境中查找
打开命令行，运行 python 或 python3,然后输入：
import sys print(sys.executable)
这会直接输出当前 Python 解释器的完整路径。
| 问题 | 解决方案 | 关键配置 |
|---|---|---|
| 代码提示不工作 | 安装并配置 LSP 和 LSP-pyright 插件。 | 在 pyright.config.json 中设置 "python.pythonPath"。 |
| 运行脚本版本不对 | 创建自定义构建系统。 | 在 .sublime-build 文件中设置 "cmd" 数组的第一个元素为你的 Python 路径。 |
对于绝大多数用户来说，同时配置好 LSP（用于代码提示）和自定义构建系统（用于运行） 是最佳实践，能确保 Sublime Text 的开发环境完全符合你的需求。
