5分钟上手：iTerm2终端内运行Python脚本全攻略
项目地址: https://gitcode.com/gh_mirrors/it/iTerm2 你还在切换窗口运行Python脚本吗？还在为终端与编辑器之间的复制粘贴烦恼吗？本文将带你解锁iTerm2的Python集成功能，只需简单配置就能在终端内直接运行、调试Python脚本，让开发效率提升300%。读完本文你将学会：Python环境配置、一键运行脚本、实时输出捕获、快捷键操作四大核心技能。
开启Python集成功能
iTerm2通过内置的Python API实现终端与脚本的无缝衔接。首先需要确保Python运行时已安装，官方推荐使用Python 3.6及以上版本。在菜单栏中找到Scripts > Install Python Runtime完成环境配置，该功能由api/library/python/iterm2/iterm2/mainmenu.py模块提供支持。
配置完成后，通过Scripts > New Python Script可以快速创建模板文件。系统提供了基础模板、触发器脚本、菜单扩展等多种类型，满足不同场景需求。所有Python相关功能的核心实现都位于api/library/python/iterm2/目录下，包含从会话管理到UI交互的完整API。
编写第一个终端脚本
创建简单的颜色测试脚本，通过iTerm2的API控制终端输出样式：
import iterm2
import asyncio
async def main(connection):
app = await iterm2.async_get_app(connection)
session = app.current_terminal_window.current_tab.current_session
# 设置终端颜色
await session.async_set_profile_property("Foreground Color", iterm2.Color(1, 0.5, 0))
# 输出彩色文本
await session.async_send_text("print('Hello iTerm2 Python API')\n")
iterm2.run_until_complete(main)
保存为color_test.py后，通过Scripts > Run Script选择文件即可执行。脚本会自动连接到当前终端会话，将字体颜色改为橙色并输出测试文本。更多API用法可参考官方文档api/library/python/iterm2/docs/conf.py。
高级功能：实时数据可视化
利用iTerm2的图像显示能力，可以在终端内直接绘制数据图表。测试目录中的tests/colors.py展示了24位颜色空间的渲染效果，通过类似方法可实现简单的数据可视化：
# 终端内绘制简单折线图
import iterm2
import asyncio
import numpy as np
async def plot_chart(connection):
session = await iterm2.async_get_current_session(connection)
data = np.sin(np.linspace(0, 2*np.pi, 50))
# 将数据转换为终端字符图
chart = []
for y in data:
bar = '#' * int((y + 1) * 20)
chart.append(f"{bar:40}")
await session.async_send_text("\n".join(chart) + "\n")
iterm2.run_until_complete(plot_chart)
运行后终端会显示正弦波形的字符图表，这种轻量级可视化方式特别适合监控脚本和数据处理场景。项目中tests/24-bit-color.sh提供了完整的色彩测试用例，可作为终端图形渲染的参考。
实用脚本与自动化场景
iTerm2的Python集成最强大之处在于自动化工作流。推荐几个实用场景：
- 测试自动化：tests/triggers.py演示了如何通过脚本监控终端输出，当出现特定关键字时自动执行响应操作
- 环境切换器：编写脚本读取不同项目的
.env文件，一键切换Python虚拟环境 - 快捷键工具：通过api/library/python/iterm2/iterm2/keyboard.py模块创建自定义快捷键，实现如"复制路径并自动生成
cd命令"等高级操作
社区贡献的tests/modern-key-reporting-test.py展示了键盘事件处理的高级用法，可作为复杂交互脚本的开发模板。
故障排除与最佳实践
常见问题解决：
- API连接失败：检查
Preferences > Advanced > Enable Python API是否勾选 - 中文乱码：在配置文件中设置
CharacterEncoding为UTF-8（api/library/python/iterm2/iterm2/profile.py） - 脚本权限：确保文件具有可执行权限且以
#!/usr/bin/env python3开头
性能优化建议：
- 长时间运行的脚本使用
asyncio事件循环 - 通过
VariableMonitor监控会话状态变化，而非轮询 - 复杂UI操作使用api/library/python/iterm2/iterm2/app.py提供的批量操作API
总结与进阶资源
iTerm2的Python集成打破了传统终端的功能边界，通过api/library/python/iterm2/iterm2/init.py定义的完整API，开发者可以构建从简单工具到复杂应用的各类解决方案。官方文档api/library/python/iterm2/docs/conf.py提供了更深入的API参考，社区维护的tests/目录包含200+个示例脚本可供学习。
立即尝试将你的常用Python脚本迁移到iTerm2环境，体验终端内一站式开发的便捷。关注项目README.md获取最新功能更新，也欢迎通过tests/目录中的测试用例贡献你的创意脚本。
提示：配合iTerm2的分屏功能，可实现"左侧编辑脚本+右侧实时运行"的高效开发模式，快捷键
Cmd+D快速分屏。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
