mac vscode如何配置latex
时间: 2025-05-24 16:18:37 浏览: 66
### Mac 系统下 VS Code 的 LaTeX 支持配置
要在 macOS 上通过 Visual Studio Code (VS Code) 编写 LaTeX 文档,需要完成以下几个方面的配置:
#### 1. 安装必要的工具链
为了能够在本地编译 LaTeX 文件,首先需要安装 **MacTex** 工具包。这是一个完整的 TeX 发行版,包含了所有必需的宏包和编译器[^1]。
可以通过访问官方页面下载并按照说明进行安装:
```bash
brew install --cask mactex-no-gui
```
如果未使用 Homebrew,则可以直接从官网下载 dmg 文件手动安装。
---
#### 2. 安装 VS Code 扩展
在 VS Code 中搜索名为 `LaTeX Workshop` 的扩展,并点击安装按钮将其添加到开发环境中[^2]。此插件提供了全面的功能支持,例如实时预览、错误检测以及多种构建命令选项。
---
#### 3. 设置默认 PDF 查看器
推荐搭配 Skim 应用作为外部 PDF 浏览程序来实现同步滚动功能。具体操作如下:
- 下载并打开 [Skim](http://skim-app.sourceforge.net/);
- 进入偏好设置 -> 同步(Sync),勾选允许脚本更改当前显示页数这一项。
接着,在终端运行以下指令赋予反向跳转权限给 VS Code:
```bash
defaults write -app Skim SKPDFExternalViewerPath "/Applications/Visual Studio Code.app/Contents/MacOS/Electron"
```
最后一步是在用户的 JSON 配置文件里指定路径参数:
```json
{
"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.latex.tools": [
{
"name": "xelatex",
"command": "xelatex",
"args": ["-synctex=1", "-interaction=nonstopmode", "-file-line-error", "%DOCFILE%"]
}
],
"latex-workshop.latex.recipes": [
{
"name": "xelatex",
"tools": ["xelatex"]
}
]
}
```
上述代码片段定义了一个基于 XeLaTeX 的工作流,并启用了标签内的嵌入式阅读模式。
---
#### 4. 构建与查看文档
保存修改后的 tex 源码之后按下快捷键组合 Ctrl+Alt+B 或者右击菜单选择对应的 recipe 开始处理项目。完成后生成的结果会被自动加载至内置窗口或者关联的应用当中展示出来。
---
### 注意事项
确保所有的依赖都已正确装载完毕后再测试整个流程;另外考虑到网络环境差异可能引起某些远程资源获取失败的情况发生时可以考虑提前离线缓存常用库版本。
阅读全文
相关推荐


















