CADLabo.comCAD / LISP / AUTOMATION
AutoLISP初心者講座

AutoLISP入門|初めてのコード・VS Code・練習問題

AutoLISPの基本・図形操作のTips一覧
このページでわかること

AutoLISPは、AutoCADに「この作業をまとめてやってね」と指示するための言葉です。毎回同じ画層を作ったり、たくさんの図形を数えたりする作業を、自分用のコマンドにまとめられます。

こんなときに使えます

プログラミング未経験で、AutoLISPをひとつずつ学びたい方。

まずは仕組みを見てみましょう

たとえば、新しい図面を作るたびに「壁用」「寸法用」「補助線用」の画層を1つずつ作っているとします。その手順をAutoLISPで用意しておけば、次からは自分で決めたコマンドを入力して、3つの画層をまとめて作れます。いつものCAD作業に、自分の仕事に合った便利な操作を加えるイメージです。まずは、毎回繰り返している小さな作業を1つ思い浮かべてみましょう。

コードを動かす手順

  1. 下の「まずは1行」で文字表示と計算を試します。
  2. VS Codeにページ下のLABHELLOコードを貼り付け、lab-hello.lspとして保存します。
  3. CADのAPPLOADで保存したファイルを読み込みます。
  4. LABHELLOを実行し、Hello, CADLabo!と表示されることを確認します。
  5. コードの文字を変えて保存し、再読み込みして表示を確認します。

このページでできるようになること

コードとCAD図面が並ぶ、明るい作業机のイラスト
コードを書いて、CADで試す。いつもの作業から始めましょう。

最初の目標は、文字を表示する自分のコマンドを作り、表示内容を変更できることです。その後、数値の計算と入力を試します。CADのコマンド欄を使ったことがあれば始められます。

  1. AutoLISPが何に使えるか知る。
  2. 1行の式を実行して、括弧の読み方を覚える。
  3. VS Codeで.lspを保存し、自分のコマンドを動かす。
  4. 入力した数値で計算し、練習問題を解く。

VS Codeがまだない方は、環境設定の手順を開きながら進めてください。

AutoLISPを使うと、どんなことができる?

普段の作業作れる専用コマンドの例
同じ画層を毎回作る決めた名前の画層をまとめて作る
選んだ図形を1つずつ数える選択した図形の数を表示する
点や寸法を指定して同じ形を描く入力した点や数値を使って作図する
決まった順序でCADコマンドを使う一連の操作を1つの名前で呼び出す

ここに挙げたのは、これから作れる処理の例です。必要な手順を書き、入力した値から期待どおりの結果になるか確認しながら作ります。

作業の手順は、どうやって伝えるの?

手順を文字で書くために使うのが、AutoLISP(オートリスプ)というプログラミング言語です。「まず何をするか」「次にどの値を使うか」を決まった書き方で並べ、AutoCADに伝えます。

その指示を書いた文字をコードと呼びます。コードを保存したものが.lspファイルで、たとえばhelloenv.lspという名前を付けられます。

コマンド名は、その処理をAutoCADで呼び出すときに入力する名前です。コードの中でHELLOENVというコマンドを作り、AutoCADに読み込めば、その名前で実行できます。ファイルは手順の保存先、コマンド名は呼び出すための名前、と覚えましょう。

VS CodeとAutoCADは、何をする道具?

道具この講座での役割
VS CodeLISPのコードを書き、.lspファイルとして保存する
AutoCAD保存したLISPを読み込み、処理を実行する

基本の流れはVS Codeで書く → 保存する → AutoCADで読み込む → 実行するです。最初はメッセージを表示するだけの短い例で、この流れを覚えましょう。

使っているCADで動く?

AutoCADはAutoLISPに対応しています。Windows版AutoCAD LTは2024以降で対応していますが、使える機能には制限があります。AutoCAD LT 2023以前やMac版LTは、同じ手順の対象になりません。他社CADは製品・グレード・使う関数ごとに確認します。

この初心者講座の環境設定は、Windows版AutoCAD 2021以降、またはAutoCAD LT 2024以降を対象に進めます。

VS Codeでの環境導入と、ボタン登録へ

この初心者講座では、VS Codeでコードを書き、AutoCADのAPPLOADで読み込んで動かします。インストールや.lspの保存先から確認したい方は、VS CodeでAutoLISPの作成環境を整えるへ。動いたコマンドをリボンのボタンにしたい方は、CUIでカスタマイズファイルを作るへ進めます。

VS Codeを読みやすく整えたい方は、VS CodeのAutoLISP用設定:色分け・括弧・字下げも確認してみてください。

まずは1行:文字を表示し、計算してみる

AutoLISP対応CADで練習用図面を開き、Escで実行中のコマンドを終了します。以下を1行ずつコマンド欄へ貼り付け、Enterを押してください。テキスト作成コマンドの入力欄には貼り付けません。

文字を表示する
(princ "Hello, CADLabo!")

Hello, CADLabo!が表示されます。この1行では、戻り値として同じ文字列がもう一度見えることがあります。

数値を計算する
(+ 10 20)

結果は30です。10 + 20のように記号を間に書く代わりに、AutoLISPでは+を先頭へ置きます。

式結果意味
(* 120 80)9600120と80を掛ける
(/ 5 2)2整数だけの割り算は整数の結果
(/ 5 2.0)2.5小数で計算したいときは実数を含める

コードは「関数 → 使う値」の順に読む

掛け算の式を、関数・引数・括弧の3つに色分けした図
先頭が「何をするか」、続く値が「何を使うか」です。
書き方意味覚えるポイント
(関数 引数…)何をするかと、使う値を並べる丸括弧が1つの指示を囲む
"Hello"文字列文字を表示するときは半角の引用符で囲む
; メモコメントセミコロンから行末まで説明を書ける
(setq width 120)widthという変数に120を入れる変数名に引用符は付けない
(* width 80)widthの値を使って計算入れた値を後から使える

括弧が重なったら、内側から

内側の足し算から実行
(* (+ 10 20) 2)

内側の(+ 10 20)が30になり、続いて30×2を計算するので結果は60です。見やすく改行・字下げしても、文字列の外なら同じ処理を書けます。

最初のファイル:保存→読み込み→実行

  1. ページ下のLABHELLOコードをVS Codeへ貼り付けます。
  2. lab-hello.lspとして保存します。文字コードや保存先は環境設定に合わせます。
  3. CADでAPPLOADを実行し、保存したファイルをロードします。
  4. ダイアログを閉じ、LABHELLOを入力してEnterを押します。
  5. VS Codeで表示文を変更し、Ctrl+Sで保存します。
  6. もう一度APPLOADで読み込んでからLABHELLOを実行します。
区別するものこの例
ファイル名lab-hello.lsp:保存してあるコード
コマンド名LABHELLO:CADに入力する名前
表示する文字Hello, CADLabo!:コード内の文字列

次の練習:幅と高さを入力して面積を計算する

幅120、高さ80を入力すると面積9600になる長方形の図
LABAREAは数値を計算する練習です。図は入力値と結果の関係を表しています。

文字表示に慣れたら、入力→計算→結果表示を1つにつなげます。次のコードをVS Codeでlab-area.lspとして保存し、APPLOADで読み込んでLABAREAを実行してください。この例は数値を計算し、図形の作成や変更は行いません。

LABAREA:数値入力を受け取る
(defun c:LABAREA (/ width height result)
  (initget 7)
  (setq width (getreal "\nWidth: "))
  (initget 7)
  (setq height (getreal "\nHeight: "))
  (setq result (* width height))
  (princ "\nArea = ")
  (princ result)
  (princ)
)
  1. Width:と表示されたら120を入力します。
  2. Height:と表示されたら80を入力します。
  3. Area = 9600.0(数値として9600)と表示されることを確認します。
コード役割
(/ width height result)このコマンドの中で使うローカル変数を宣言
(initget 7)直後の入力で空入力・0・負数を受け付けない
(getreal …)入力された数値を受け取る
(setq result (* width height))掛け算の結果をresultへ入れる

initgetの設定は次の入力1回に適用されるため、幅と高さのそれぞれの前に置きます。中断するときはEscを押します。単位は自動判定しません。両方をmmで入力すれば結果はmm²、mで入力すればm²です。

練習問題:1か所ずつ変えて確かめよう

まず自分で予想し、CADで結果を見てから答えを開きましょう。

練習1:表示する文字を変える

LABHELLOの表示をMy first LISPへ変えてください。

答えと確認方法
変更する行
(princ "\nMy first LISP")

保存した後、APPLOADで再読み込みし、LABHELLOを実行します。

練習2:計算結果を予想する

(+ (* 3 4) 5)の結果はいくつでしょう?

答えを見る

17です。先に3×4を計算し、その結果12に5を足します。

練習3:入力を変更する

LABAREAへ幅150、高さ80を入力してみましょう。

答えを見る

面積は12000です。幅だけを変更したことで、前の9600から増えます。0や負数を入れた場合は再入力になることも確認します。

練習4:面積を外周の長さへ変える

幅120、高さ80の長方形の外周は400です。計算行と表示ラベルをどう変えますか?

答えを見る
計算行と表示ラベル
(setq result (* 2 (+ width height)))
(princ "\nPerimeter = ")

元の2行を置き換え、続く(princ result)は残します。保存・再読み込みして確認しましょう。

つまずいたら:症状から確認する

症状・メッセージ例最初に見るところ直した後の確認
不明なコマンド現在の図面でロードしたか、defun c:の名前と入力名が一致するかAPPLOADの成功を確認してコマンド名を入力
malformed list / 括弧に関するエラー丸括弧の不足・余分な括弧、全角の記号VS Codeで括弧の対応を見て保存・再読み込み
文字列・入力が終わらない半角のダブルクォートの閉じ忘れEscで戻り、引用符を直す
bad argument type数値が必要な場所へ文字列やnilを渡していないか入力値とsetqの代入箇所を確認
変更したのに古い結果保存し忘れ、同名ファイル、再読み込み忘れ保存先を照合してAPPLOADで読み直す
日本語が文字化け保存時の文字コードとCAD側の対応元ファイルを残して文字コードを確認

エラー文は製品や版で異なります。質問するときは、CADの製品・年版、実行したコマンド名、エラー全文、該当コードをそろえると原因を追いやすくなります。

初めての人のよくある質問

英語や数学が得意でないと難しい?

最初は短い関数名と、足し算・掛け算が分かれば始められます。図形の座標や角度は、作図へ進むときに少しずつ学びましょう。

全部の関数を暗記した方がよい?

最初はprinc、setq、defunの役割を確認し、必要な関数を公式資料で調べながら使えば大丈夫です。

VS Codeの実行ボタンを押せば動く?

この講座ではVS Codeで保存し、CADのAPPLOADで読み込みます。AutoLISPを実行するのは対応CADです。

BricsCADでも練習できる?

使用する版のLISP対応を確認してください。基本的な式は共通するものが多い一方、AutoCAD専用の拡張機能・デバッグや製品固有の機能は区別して扱います。

ここまでできたら、次に進もう

AutoLISP講座の一覧へ戻る

たとえば、こんな使い方

lab-hello.lspを読み込んでLABHELLOを実行します。Hello, CADLabo!をHello, Zumen!へ変更し、保存・再読み込み・再実行すると表示が変わります。ファイル名とコマンド名は別々に付けられます。

自分のコマンドを作り、表示を変更する

VS CodeとCADを行き来して、コードの変更を反映しましょう。

  1. LABHELLOをlab-hello.lspとして保存します。
  2. APPLOADで読み込み、LABHELLOを実行します。
  3. 表示文を変えて保存し、同じファイルを再読み込みします。
  4. LABHELLOを再実行し、新しい文字に変わるか確認します。

確認する結果

表示を変えられたら、入力と計算のLABAREAへ進みましょう。

コード

lab-hello.lsp
(defun c:LABHELLO ()
  (princ "\nHello, CADLabo!")
  (princ)
)

.lspファイルをダウンロード 無料

コードをひとつずつ見てみましょう

  1. defunは関数を作る指示です。c:LABHELLOのc:を付けると、LABHELLOというコマンド名で呼び出せます。
  2. 名前の後の()は、引数やローカル変数がないことを表します。省略せずに書きます。
  3. princで文字を表示します。文字列の先頭の\nは改行の指定です。
  4. 最後の(princ)は、余分な戻り値を表示せずに終えるための書き方です。
  5. 一番外側の閉じ括弧で、LABHELLOの定義を閉じます。

つまずきやすいポイント

「図面をきれいにする」だけでは手順が決まりません。何を選び、どの値を使い、何を変えるのかを具体的にしてからコードへ進みましょう。

うまくいかないときは

自動化する作業が思い浮かばなければ、次の環境設定で文字を表示する例を試しましょう。短い処理が動けば、書く・保存する・読み込む・実行する流れを確認できます。

公式資料・確認範囲

資料確認:2026-10-14。操作は主に AutoCAD / AutoCAD LT 2024以降(Windows、LISP対応環境) を想定。資料の対象年はリンクに記載しています。画面や選択肢はバージョンで異なる場合があります。