理系の必須ツールLaTeX環境構築(Mac編)【新歓ブログリレー2026 vol.6】

{
    // 一般の設定
    "editor.wordWrap": "on", // 画面端で長い行を折り返します（横スクロールの手間がなくなります）。
    "files.autoSave": "onFocusChange", // 別のウィンドウをクリックするなどしてフォーカスが外れた瞬間に自動保存します。
    "explorer.confirmDelete": false, // ファイル削除時の「本当に削除しますか？」という確認ポップアップを消します。
    "explorer.confirmDragAndDrop": false, // ドラッグ＆ドロップ移動時の確認ポップアップを消します。
    "editor.minimap.enabled": false, // エディタ右端にある縮小コード表示（ミニマップ）を消して画面を広く使います。
    "editor.renderWhitespace": "all", // スペースやタブを薄い記号（・や→）で可視化します。全角スペースの混入ミスに気づきやすくなります。

    // ◼︎ デフォルト設定 ◼︎
    "latex-workshop.latex.recipe.default": "latexmk (uplatex)", // デフォルトで使用するビルドレシピを指定（下のrecipesで定義したもの）
    "files.associations": {
        "*.tex": "latex" // .texファイルをLaTeX言語として認識させる
    },
    
    // ■ ディレクトリ・出力設定 ■
    "latex-workshop.latex.outDir": "./out", // PDFや中間ファイル（aux, log等）をワークスペース直下の "out" フォルダに出力して整理する
    "latex-workshop.latex.autoClean.run": "onBuilt", // ビルド成功時に不要な中間ファイルを自動削除する

    // ■ レシピ設定 (ビルドの手順書) ■
    "latex-workshop.latex.recipes": [
        {
            "name": "latexmk (uplatex)", // レシピの名前（左下のメニュー等に表示される）
            "tools": [
                "latexmk" // このレシピで実行するツール名（下のtoolsで定義したもの）
            ]
        }
    ],

    // ■ ツール詳細設定 (コマンドの中身) ■
    "latex-workshop.latex.tools": [
        {
            "name": "latexmk", // ツール名
            "command": "latexmk", // 実行するコマンド
            "args": [
                "-e", // 次の行のPerlコードを実行するオプション
                "$latex=q/uplatex %O -kanji=utf8 -no-guess-input-enc -synctex=1 -interaction=nonstopmode -file-line-error %S/", // 【重要】uplatexの設定。UTF-8強制、SyncTeX有効化(ジャンプ機能用)、エラー時に行番号表示など
                "-e",
                "$bibtex=q/upbibtex %O %B/", // upbibtexの設定（参考文献処理用）
                "-e",
                "$biber=q/biber %O --bblencoding=utf8 -u -U --output_safechars %B/", // biberの設定（より高度な参考文献処理用）
                "-e",
                "$makeindex=q/upmendex %O -o %D %S/", // upmendexの設定（索引作成用）
                "-e",
                "$dvipdf=q/dvipdfmx %O -o %D %S/", // dvipdfmxの設定（DVIからPDFへの変換用）
                "-outdir=%OUTDIR%", // ★VSCodeの"outDir"設定をlatexmkに渡す（これが無いと出力先が変わらない）
                "-norc",    // ホームディレクトリ等の .latexmkrc ファイルを無視し、この設定を優先する
                // "-gg",      // クリーンアップして強制リビルド。ビルド失敗が続く場合に有効だが、毎回だと遅くなるため普段はOFF推奨
                "-pdfdvi",  // DVIを経由してPDFを作成するモードを指定
                "%DOC%" // 処理対象のルートファイル（拡張子なし）
            ],
            "env": {} // 環境変数の追加（通常は空でOK）
        }
    ],

    // ■ 自動ビルド・表示・連携設定 ■
    "latex-workshop.latex.autoBuild.run": "onFileChange", // ファイルが変更されたタイミングでビルドを検討する
    "latex-workshop.latex.autoBuild.onSave.enabled": true, // ファイル保存時に自動でビルドを実行する
    "latex-workshop.view.pdf.viewer": "tab", // VS Code内のタブでPDFを表示。
    "latex-workshop.view.pdf.internal.synctex.keybinding": "ctrl-click", // PDFをCommand+クリックすると、該当するコードへジャンプ。

    // ■ クリーンアップ設定 (削除対象ファイル) ■
    "latex-workshop.latex.clean.fileTypes": [
        "*.aux", "*.bbl", "*.blg", "*.idx", "*.ind", "*.lof", "*.lot", "*.out", "*.toc", "*.acn", "*.acr", "*.alg", "*.glg", "*.glo", "*.gls", "*.ist", "*.fls", "*.log", "*.fdb_latexmk", "*.dvi", "*.synctex.gz"
    ],

    // ■ 補完・構文チェック設定 ■
    "latex-workshop.chktex.enabled": true, // chktexの有効化
    "latex-workshop.intellisense.package.enabled": true, // \usepackage{...} の補完を効かせる。
    "latex-workshop.linting.chktex.enabled": true, // 文法ミスを波線で教えてくれる（chktexのインストールが必要）。
}
    

Copy

\documentclass[uplatex, dvipdfmx]{jsarticle}
\usepackage{float}
\usepackage[dvipdfmx]{graphicx}

% --- 必須パッケージの読み込み ---
\usepackage[T1]{fontenc}      % 欧文フォントのエンコーディング指定
\usepackage{textcomp}         % 特殊記号の補完
\usepackage[utf8]{inputenc}   % ソースコードの文字コード
\usepackage{lmodern}          % Latin Modernフォント（数式・欧文が綺麗になる）

\usepackage{amsmath, amssymb} % 数式用パッケージ（必須）
\usepackage{mathtools}        % amsmathの拡張
\usepackage{booktabs}         % 美しい表を作成する（\toprule 等）
\usepackage{url}              % URLを表示する
\usepackage[dvipdfmx]{hyperref} % PDFにしおりやリンクを埋め込む

% --- 参考文献データ（自動生成） ---
% 本来は .bib ファイルを別に作りますが、テスト用にここで生成します
\begin{filecontents*}{reference.bib}
@book{knuth84,
  author    = {Donald E. Knuth},
  title     = {The TeXbook},
  publisher = {Addison-Wesley},
  year      = {1984}
}
@article{einstein1905,
  author  = {Albert Einstein},
  title   = {Zur Elektrodynamik bewegter K{\"o}rper},
  journal = {Annalen der Physik},
  volume  = {322},
  number  = {10},
  pages   = {891--921},
  year    = {1905}
}
@book{松島17,
  author = {松島 与三},
  title = {多様体入門},
  publisher = {裳華房},
  year = {2017}
}
\end{filecontents*}
% ---------------------------------

% --- 文書情報 ---
\title{LaTeX 環境構築 動作確認テスト}
\author{VS Code User}
\date{\today}

\begin{document}

\maketitle

\begin{abstract}
この文書は、VS Code上のLaTeX環境（uplatex + latexmk）において、日本語処理、数式環境、図表の挿入、および参考文献の自動生成処理（BibTeX）が正常に動作するかを検証するためのものです。
\end{abstract}

% 目次の出力（2回以上のコンパイルが必要だがlatexmkなら自動）
\tableofcontents
\clearpage

\section{数式のテスト}
インライン数式 $E=mc^2$ および、別行立て数式のテストです。
以下はガウス積分と、マクスウェル方程式の一部です。

\begin{align}
    \int_{-\infty}^{\infty} e^{-x^2} \, dx &= \sqrt{\pi} \label{eq:gauss} \\
    \nabla \times \mathbf{B} &= \mu_0 \mathbf{J} + \mu_0 \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t}
\end{align}

式(\ref{eq:gauss})は参照機能（cross-reference）のテストです。クリックしてジャンプできれば成功です。

\section{図表のテスト}

\subsection{画像の挿入}
画像ファイル（\texttt{figure.pdf}）を用意して、下の\textbackslash includegraphicsの行のコメントアウトを解除して下さい。

画像のファイル名は違うものでも構いませんが、その場合は\textbackslash includegraphicsの行の\{\}内のファイル名もご自身の画像ファイル名と同じものに変更して下さい。

\begin{figure}[H]
    \centering
    % ↓ここに画像を入れてください
    % \includegraphics[width=0.6\linewidth]{figure.pdf}
    
    \caption{テスト画像の表示確認}
    \label{fig:test_image}
\end{figure}

図\ref{fig:test_image}が表示されていれば、\texttt{graphicx}パッケージは正常です。

\subsection{表の作成}
学術論文で推奨される \texttt{booktabs} パッケージを使用した表組みです。

\begin{table}[H]
    \centering
    \caption{主なTeXエンジンの比較}
    \label{tab:engines}
    \begin{tabular}{llc} \toprule
        エンジン名 & 特徴 & Unicode対応 \\ \midrule
        pLaTeX     & 伝統的、資産が多い & $\triangle$ \\
        upLaTeX    & pLaTeXの上位互換 & $\bigcirc$ \\
        LuaLaTeX   & スクリプト制御可能 & $\bigcirc$ \\ \bottomrule
    \end{tabular}
\end{table}

\section{参考文献と引用のテスト}
文献引用のテストです。Knuthの書籍\cite{knuth84}や、Einsteinの相対性理論の論文\cite{einstein1905}, 日本語の文献として\cite{松島17}を引用します。
巻末に参考文献リストが生成されているか確認してください。

% 参考文献リストの出力
\bibliographystyle{jplain} % 日本語用の標準スタイル
\bibliography{reference}   % reference.bib を読み込む

\end{document}
    
    

Copy

	"LaTeX Template": {
        "prefix": "latex_sample",
        "body": [
            "\\documentclass[uplatex, dvipdfmx]{jsarticle}",
            "",
            "\\usepackage{amsmath, amssymb} % 数式用パッケージ",
            "\\usepackage{bm}               % 太字の数式用",
            "\\usepackage{booktabs}         %綺麗な表作成のため",
            "\\usepackage{graphicx}         % 画像の挿入用",
            "\\usepackage{url}              % URLを表示するため",
            "\\usepackage{float}             % 図表を強制的にその場所に配置する (Hオプション)",
            "",
            "\\begin{document}",
			"",
            "\\title{${1:LaTeXの基本機能まとめ}}",
            "\\author{${2:あなたの名前}}",
            "\\date{\\today}",
            "\\maketitle",
            "",
            "\\section{${3:はじめに}}",
            "これは、LaTeXで頻繁に使用される機能をまとめたサンプルファイルです。",
			"VS Codeでのビルドテストや、構文のコピー＆ペースト用として活用してください。",
            "",
            "\\section{数式の例}",
            "\\subsection{基本的な数式}",
			"行内数式は \\$$E = mc^2\\$ のように書きます。",
			"ディスプレイ数式（別行立て）は以下のように書きます。",
			"\\[",
			"  f(x) = \\int_{-\\infty}^{\\infty} e^{-x^2} dx = \\sqrt{\\pi}",
			"\\]",
			"",
			"\\subsection{複数の式を並べる (align と gather)}",
			"\\textbf{align環境}：特定の位置（通常はイコール）で揃えたい場合に使います。",
            "\\begin{align}",
            "  f(x) &= (x+1)(x-1) \\\\\\\\",
            "       &= x^2 - 1",
            "\\end{align}",
            "",
            "\\textbf{gather環境}：位置を揃えず、単に式を中央に並べたい場合に使います。",
            "\\begin{gather*}",
            "  a + b = c \\\\\\\\",
            "  x = y + z + w",
            "\\end{gather*}",
			"",
			"数式番号はgather*など後ろに*をつけることで非表示にできます。",
            "",
            "\\subsection{場合分け (cases)}",
			"条件によって式が変わる場合は cases 環境を使います。",
            "\\begin{equation}",
            "  |x| = ",
			"  \\begin{cases} ",
			"    x & (x \\ge 0) \\\\\\\\",
			"    -x & (x < 0)",
			"  \\end{cases}",
            "\\end{equation}",
            "",
            "\\subsection{行列と括弧}",
			"行列には pmatrix (丸括弧) や bmatrix (角括弧) を使います。",
            "\\[",
            "  A = ",
			"  \\begin{pmatrix}",
			"    \\alpha & \\beta \\\\\\\\",
			"    \\gamma & \\delta",
			"  \\end{pmatrix}, \\quad",
			"  \\bm{v} = ",
			"  \\begin{bmatrix}",
			"    v_1 \\ v_2",
			"  \\end{bmatrix}",
            "\\]",
			"括弧の高さを自動調整するには \\texttt{\\textbackslash left( ... \\textbackslash right)} を使います。",
			"\\[",
			"  \\left( \\frac{1}{2} \\right)^n",
			"\\]",
            "",
            "\\section{表の作成}",
			"表の作成例です。論文では縦線をなるべく使わない「三線表」が推奨されます。",
			"",
			"\\subsection{一般的な表 (罫線あり)}",
            "\\begin{table}[H]",
            "  \\centering",
            "  \\caption{基本的な表}",
            "  \\label{tab:label}",
            "  \\begin{tabular}{|c|l|r|} \\hline",
            "    中央揃え & 左揃え & 右揃え \\\\\\\\ \\hline",
            "    Apple & Item1 & 100 \\\\\\\\ \\hline",
            "    Banana & Item2 & 10000 \\\\\\\\ \\hline",
            "  \\end{tabular}",
            "\\end{table}",
            "",
			"\\subsection{論文などでよく使われている表 (booktabs使用)}",
			"\\texttt{booktabs} パッケージを使った、それっぽい表組みです。",
			"\\begin{table}[H]",
			"  \\centering",
			"  \\caption{見やすい三線表}",
			"  \\label{tab:sample} % 参照用のラベル",
			"  \\begin{tabular}{lcr} \\toprule",
			"    項目 & 内容 & 数値 \\\\\\\\ \\midrule",
			"    Apple & 赤い果物 & 150 \\\\\\\\",
			"    Banana & 黄色い果物 & 80 \\\\\\\\ \\bottomrule",
			"  \\end{tabular}",
			"\\end{table}",
			"",
			"\\section{箇条書きと参照}",
			"",
			"\\subsection{箇条書きの種類}",
			"\\begin{itemize}",
			"    \\item 記号付き箇条書き",
			"    \\item itemize環境を使います",
			"\\end{itemize}",
			"",
			"\\begin{enumerate}",
  			"  \\item 番号付き箇条書き",
   			"  \\item enumerate環境を使います",
    		"    \\begin{enumerate}",
      		"      \\item ネスト（入れ子）も可能です",
    		"    \\end{enumerate}",
			"\\end{enumerate}",
			"",
			"\\subsection{相互参照}",
			"表\\ref{tab:sample}をご覧ください。このように \\texttt{\\textbackslash ref} コマンドを使うことで、",
			"番号が自動的に振られた図表や数式番号を参照できます。",
			"数式(\\ref{eq:maxwell})も参照可能です（数式番号をつけるには \\texttt{equation} 環境を使います）。",
			"",
			"\\begin{equation}",
  			"  \\label{eq:maxwell}",
  			"  \\nabla \\cdot \\bm{E} = \\frac{\\rho}{\\varepsilon_0}",
			"\\end{equation}",
			"",
			"\\section{図の挿入}",
			"実際には gazou.pngというファイル名の画像をカレントフォルダに置いて\\textbackslash includegraphics..の行のコメントアウトをはずして下さい。ファイル名は変更してももちろん構いませんが、その際は\\textbackslash includegraphics..の行も一緒に書き換えて下さい。",
			"",
			"\\begin{figure}[H]",
  			"  \\centering",
  			"  % width=5cmなどでサイズ指定。実際のファイルを使うときは以下のように書く",
  			"  % \\includegraphics[width=6cm]{gazou.png}",
  			"  \\caption{画像をカレントフォルダに置くと上に画像が表示されます。}",
  			"  \\label{fig:figure}",
			"\\end{figure}",
            "",
            "\\end{document}"
        ],
        "description": "LaTeXの数式・表・図などのよく使う機能を含んだテンプレート"
    }
    

Copy